Metodo IDebugDataSpaces4::ReadTagged (dbgeng.h)

Articolo
02/23/2024

Il metodo ReadTagged legge i dati contrassegnati che potrebbero essere associati a una sessione del debugger.

Sintassi

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

Parametri

[in] Tag

Specifica il GUID che identifica i dati richiesti.

[in] Offset

Specifica l'offset all'interno dei dati da leggere.

[out, optional] Buffer

Riceve i dati. Se Buffer è NULL, i dati non vengono restituiti.

[in] BufferSize

Specifica le dimensioni in byte del buffer buffer. Si tratta del numero massimo di byte che verranno restituiti.

[out, optional] TotalSize

Riceve le dimensioni totali in byte dei dati specificati da Tag.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_NOINTERFACE	Non sono stati trovati dati identificati da Tag .

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere Valori restituiti .

Commenti

Alcune sessioni del debugger hanno dati aggiuntivi arbitrari disponibili. Ad esempio, quando viene creato un file di dump, possono essere creati anche file di informazioni di dump aggiuntive contenenti informazioni aggiuntive. Questi dati aggiuntivi vengono contrassegnati con un identificatore univoco globale e possono essere recuperati solo tramite il tag .

LPGUID è un puntatore a un identificatore univoco a 128 bit. Viene definito nel file di intestazione Microsoft Windows SDK guiddef.h.