Fungsi EventAccessQuery (evntcons.h)

Mengambil izin untuk pengontrol atau penyedia yang ditentukan.

Sintaks

ULONG EVNTAPI EventAccessQuery(
  [in]      LPGUID               Guid,
  [in, out] PSECURITY_DESCRIPTOR Buffer,
  [in, out] PULONG               BufferSize
);

Parameter

[in] Guid

GUID yang secara unik mengidentifikasi penyedia atau sesi.

[in, out] Buffer

Buffer yang dialokasikan aplikasi yang akan berisi deskriptor keamanan pengontrol atau penyedia.

[in, out] BufferSize

Ukuran buffer deskriptor keamanan, dalam byte. Jika fungsi berhasil, parameter ini menerima ukuran buffer yang digunakan. Jika buffer terlalu kecil, fungsi mengembalikan ERROR_MORE_DATA dan parameter ini menerima ukuran buffer yang diperlukan. Jika ukuran buffer nol pada input, tidak ada data yang dikembalikan dalam buffer dan parameter ini menerima ukuran buffer yang diperlukan.

Nilai kembali

Mengembalikan ERROR_SUCCESS jika berhasil.

Fungsi mengembalikan kode pengembalian berikut jika terjadi kesalahan:

Menampilkan kode	Deskripsi
ERROR_MORE_DATA	Buffer terlalu kecil untuk menerima deskriptor keamanan. Realokasikan buffer menggunakan ukuran yang dikembalikan dalam BufferSize.

Keterangan

Jika GUID tidak ada di registri, ETW mengembalikan izin default untuk penyedia atau pengontrol. Untuk detail tentang menentukan GUID di registri, lihat EventAccessControl.

Untuk informasi tentang mengakses komponen deskriptor keamanan, lihat Mendapatkan Informasi dari ACL, fungsi GetSecurityDescriptorDacl, GetSecurityDescriptorSacl, dan GetAce , dan struktur ACE .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	evntcons.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

EventAccessControl

EventAccessRemove