IDebugDataSpaces3::ReadTagged-Methode (dbgeng.h)

Artikel
02/23/2024

Die ReadTagged-Methode liest die markierten Daten, die möglicherweise einer Debuggersitzung zugeordnet sind.

Syntax

HRESULT ReadTagged(
  [in]            LPGUID Tag,
  [in]            ULONG  Offset,
  [out, optional] PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG TotalSize
);

Parameter

[in] Tag

Gibt die GUID an, die die angeforderten Daten identifiziert.

[in] Offset

Gibt den Offset innerhalb der zu lesenden Daten an.

[out, optional] Buffer

Empfängt die Daten. Wenn BufferNULL ist, werden die Daten nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Byte an. Dies ist die maximale Anzahl von Bytes, die zurückgegeben werden.

[out, optional] TotalSize

Empfängt die Gesamtgröße der durch Tag angegebenen Daten in Byte.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_NOINTERFACE	Es konnten keine durch Tag identifizierten Daten gefunden werden.

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

Einige Debuggersitzungen verfügen über beliebige zusätzliche Daten. Wenn beispielsweise eine Speicherabbilddatei erstellt wird, können auch zusätzliche Speicherabbildinformationsdateien erstellt werden, die zusätzliche Informationen enthalten. Diese zusätzlichen Daten werden mit einem globalen eindeutigen Bezeichner markiert und können nur über das Tag abgerufen werden.

LPGUID ist ein Zeiger auf einen eindeutigen 128-Bit-Bezeichner. Sie ist in der Microsoft Windows SDK-Headerdatei guiddef.h definiert.