Metode IDebugDataSpaces4::ReadTagged (dbgeng.h)

Artikel
02/26/2024

Metode ReadTagged membaca data yang diberi tag yang mungkin terkait dengan sesi debugger.

Sintaks

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

Parameter

[in] Tag

Menentukan GUID yang mengidentifikasi data yang diminta.

[in] Offset

Menentukan offset dalam data yang akan dibaca.

[out, optional] Buffer

Menerima data. Jika BufferNULL, data tidak dikembalikan.

[in] BufferSize

Menentukan ukuran dalam byte buffer Buffer. Ini adalah jumlah maksimum byte yang akan dikembalikan.

[out, optional] TotalSize

Menerima ukuran total dalam byte data yang ditentukan oleh Tag.

Nilai kembali

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_NOINTERFACE	Tidak ada data yang diidentifikasi oleh Tag yang dapat ditemukan.

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Keterangan

Beberapa sesi debugger memiliki data tambahan arbitrer yang tersedia. Misalnya, saat file cadangan dibuat, file informasi cadangan tambahan yang berisi informasi tambahan juga dapat dibuat. Data tambahan ini ditandai dengan pengidentifikasi unik global dan hanya dapat diambil melalui tag .

LPGUID adalah penunjuk ke pengidentifikasi unik 128-bit. Ini didefinisikan dalam file header Microsoft Windows SDK guiddef.h.