ReadTagged

The ReadTagged method reads the tagged data that might be associated with a debugger session.

HRESULT
  IDebugDataSpaces3::ReadTagged(
    IN LPGUID  Tag,
    IN ULONG  Offset,
    OUT OPTIONAL PVOID  Buffer,
    IN ULONG  BufferSize,
    OUT OPTIONAL PULONG  TotalSize
    );

Parameters

Tag

Specifies the GUID identifying the data requested.

Offset

Specifies the offset within the data to read.

Buffer

Receives the data. If Buffer is NULL, the data is not returned.

BufferSize

Specifies the size in bytes of the buffer Buffer. This is the maximum number of bytes that will be returned.

TotalSize

Receives the total size in bytes of the data specified by Tag.

Return Value

S_OK

The method was successful.

E_NOINTERFACE

No data identified by Tag could be found.

This method can also return error values. See Return Values for more details.

Interface Version

ReadTagged is available in IDebugDataSpaces3 and later versions.

Comments

Some debugger sessions have arbitrary additional data available. For example, when a dump file is created, additional dump information files containing extra information may also be created. This additional data is tagged with a global unique identifier and can only be retrieved via the tag.

LPGUID is a pointer to a 128-bit unique identifier. It is defined in the Microsoft Windows SDK header file guiddef.h.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

GetNextTagged