Fungsi TdhGetWppProperty (tdh.h)

Artikel
03/04/2024

Mengambil properti tertentu yang terkait dengan pesan WPP.

Sintaks

TDHSTATUS TdhGetWppProperty(
  [in]      TDH_HANDLE    Handle,
  [in]      PEVENT_RECORD EventRecord,
  [in]      PWSTR         PropertyName,
  [in, out] PULONG        BufferSize,
  [out]     PBYTE         Buffer
);

Parameter

[in] Handle

Jenis: TDH_HANDLE

Handel decoding yang valid.

[in] EventRecord

Jenis: PEVENT_RECORD

Rekaman peristiwa diteruskan ke panggilan balik EventRecordCallback Anda.

[in] PropertyName

Jenis: PWSTR

Nama properti yang akan diambil.

Untuk daftar nilai yang mungkin, lihat PROPERTY_DATA_DESCRIPTOR.

[in, out] BufferSize

Jenis: PULONG

Ukuran parameter Buffer , dalam byte.

[out] Buffer

Jenis: PBYTE

Buffer yang dialokasikan pengguna yang menerima data properti.

Mengembalikan nilai

Jenis: ULONG

Mengembalikan ERROR_SUCCESS jika berhasil. Jika tidak, fungsi ini mengembalikan salah satu kode pengembalian berikut selain yang lain.

Menampilkan kode	Deskripsi
ERROR_NOT_FOUND	Properti yang ditentukan tidak ditemukan.
ERROR_INSUFFICIENT_BUFFER	BufferSize terlalu kecil. Untuk mendapatkan ukuran buffer yang diperlukan, panggil TdhGetWppProperty dua kali, sekali dengan buffer null dan pointer untuk mengambil ukuran buffer dan kemudian lagi dengan buffer berukuran benar.
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter salah. Kesalahan ini dikembalikan jika parameter Handle, EventRecord, PropertyName, atau Buffer adalah NULL.

Keterangan

Untuk hanya mengambil pesan peristiwa yang didekodekan tanpa menentukan nama properti, panggil TdhGetWppMessage.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	tdh.h
Pustaka	Tdh.lib
DLL	Tdh.dll

Lihat juga

Bagikan melalui