IDebugDataSpaces3::ReadTagged-Methode (dbgeng.h)

Artikel
02/06/2025

Die ReadTagged-Methode liest die markierten Daten, die einer Debuggersitzung zugeordnet werden können.

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 Puffer-NULL-ist, werden die Daten nicht zurückgegeben.

[in] BufferSize

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

[out, optional] TotalSize

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

Rückgabewert

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
E_NOINTERFACE	Es wurden keine Daten gefunden, die von Tag- identifiziert wurden.

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

Bemerkungen

Einige Debuggersitzungen verfügen über beliebige zusätzliche Daten. Wenn beispielsweise eine Speicherabbilddatei erstellt wird, können auch zusätzliche Speicherabbild-Informationsdateien 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 wird in der Microsoft Windows SDK-Headerdatei guiddef.h definiert.