Metode IDebugDataSpaces4::ReadHandleData (dbgeng.h)

  • Artikel

Metode ReadHandleData mengambil informasi tentang objek sistem yang ditentukan oleh handel sistem.

Sintaks

HRESULT ReadHandleData(
  [in]            ULONG64 Handle,
  [in]            ULONG   DataType,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  DataSize
);

Parameter

[in] Handle

Menentukan handel sistem objek yang datanya diminta. Lihat Menangani untuk informasi tentang handel sistem.

[in] DataType

Menentukan jenis data yang akan dikembalikan untuk handel sistem. Tabel berikut berisi nilai yang valid, bersama dengan jenis pengembalian terkait:

Nilai Deskripsi
DEBUG_HANDLE_DATA_TYPE_BASIC Mengembalikan informasi dasar tentang objek sistem.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PDEBUG_HANDLE_DATA_BASIC.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME Mengembalikan nama jenis objek. Misalnya, "Proses" atau "Utas".

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PSTR.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME Mengembalikan nama objek. Ini termasuk lokasinya di direktori objek.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PSTR.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT Mengembalikan jumlah handel yang dipegang oleh objek . Ini mirip dengan bidang DEBUG_HANDLE_DATA_BASIC. HandleCount.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PULONG.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE Mengembalikan nama jenis objek.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PWSTR
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE Mengembalikan nama objek.

Dalam hal ini, buffer argumen dapat dianggap memiliki jenis PWSTR.

[out, optional] Buffer

Menerima data objek. Setelah berhasil menyelesaikan metode , konten buffer ini dapat diakses dengan mentransmisikan Buffer ke jenis yang ditentukan dalam tabel di atas.

Jika BufferNULL, informasi ini tidak dikembalikan.

[in] BufferSize

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

[out, optional] DataSize

Menerima ukuran data dalam byte. Jika DataSizeNULL, informasi ini tidak dikembalikan.

Nilai kembali

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
 

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

Keterangan

Metode ini hanya tersedia dalam penelusuran kesalahan mode pengguna.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h)

Lihat juga

Handles

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4