Skip to content

Latest commit

 

History

History
128 lines (91 loc) · 3.44 KB

nf-dbgeng-idebugdataspaces4-readtagged.md

File metadata and controls

128 lines (91 loc) · 3.44 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:dbgeng.IDebugDataSpaces4.ReadTagged
IDebugDataSpaces4::ReadTagged (dbgeng.h)
The ReadTagged method reads the tagged data that might be associated with a debugger session.
debugger\readtagged.htm
debugger
05/03/2018
IDebugDataSpaces4::ReadTagged
IDebugDataSpaces3 interface [Windows Debugging],ReadTagged method, IDebugDataSpaces3::ReadTagged, IDebugDataSpaces4 interface [Windows Debugging],ReadTagged method, IDebugDataSpaces4.ReadTagged, IDebugDataSpaces4::ReadTagged, IDebugDataSpaces_cdf64ddf-da14-4607-8df2-1d4703a2eebf.xml, ReadTagged, ReadTagged method [Windows Debugging], ReadTagged method [Windows Debugging],IDebugDataSpaces3 interface, ReadTagged method [Windows Debugging],IDebugDataSpaces4 interface, dbgeng/IDebugDataSpaces3::ReadTagged, dbgeng/IDebugDataSpaces4::ReadTagged, debugger.readtagged
dbgeng.h
Dbgeng.h
Desktop
Windows
IDebugDataSpaces4::ReadTagged
dbgeng/IDebugDataSpaces4::ReadTagged
APIRef
kbSyntax
COM
dbgeng.h
IDebugDataSpaces4::ReadTagged

IDebugDataSpaces4::ReadTagged

-description

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

-parameters

-param Tag [in]

Specifies the GUID identifying the data requested.

-param Offset [in]

Specifies the offset within the data to read.

-param Buffer [out, optional]

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

-param BufferSize [in]

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

-param TotalSize [out, optional]

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

-returns

Return code Description
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.

-remarks

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.

-see-also

GetNextTagged

IDebugDataSpaces3

IDebugDataSpaces4