Metodo IDebugDataSpaces4::ReadTagged (dbgeng.h)

2025-02-06

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 ha avuto esito positivo.
E_NOINTERFACE	Non sono stati trovati dati identificati da Tag.

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

Osservazioni

Alcune sessioni del debugger hanno dati aggiuntivi arbitrari disponibili. Ad esempio, quando viene creato un file 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 di Microsoft Windows SDK guiddef.h.