Fungsi LsaQueryInformationPolicy (ntsecapi.h)

Artikel
03/15/2023

Fungsi LsaQueryInformationPolicy mengambil informasi tentang objek Policy .

Sintaks

NTSTATUS LsaQueryInformationPolicy(
  [in]  LSA_HANDLE               PolicyHandle,
  [in]  POLICY_INFORMATION_CLASS InformationClass,
  [out] PVOID                    *Buffer
);

Parameter

[in] PolicyHandle

Handel ke objek Policy . Hak akses yang diperlukan untuk handel ini bergantung pada nilai parameter InformationClass . Untuk informasi selengkapnya, lihat Membuka Penanganan Objek Kebijakan.

[in] InformationClass

Menentukan salah satu nilai berikut dari jenis enumerasi POLICY_INFORMATION_CLASS . Nilai menunjukkan jenis informasi yang akan diambil.

Nilai	Makna
PolicyAuditEventsInformation	Mengambil aturan audit sistem. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_VIEW_AUDIT_INFORMATION. Parameter Buffer menerima pointer ke struktur POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation	Mengambil nama dan SID domain utama sistem. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_VIEW_LOCAL_INFORMATION. Parameter Buffer menerima pointer ke struktur POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation	Mengambil nama dan SID domain akun sistem. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_VIEW_LOCAL_INFORMATION. Parameter Buffer menerima pointer ke struktur POLICY_ACCOUNT_DOMAIN_INFO .
PolicyLsaServerRoleInformation	Mengambil peran server LSA. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_VIEW_LOCAL_INFORMATION. Parameter Buffer menerima pointer ke struktur POLICY_LSA_SERVER_ROLE_INFO .
PolicyModificationInformation	Mengambil informasi tentang waktu pembuatan dan modifikasi terakhir database LSA. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_VIEW_LOCAL_INFORMATION. Parameter Buffer menerima penunjuk ke struktur POLICY_MODIFICATION_INFO .
PolicyDnsDomainInformation	Mengambil informasi Sistem Nama Domain (DNS) tentang domain utama yang terkait dengan objek Kebijakan . Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_VIEW_LOCAL_INFORMATION. Parameter Buffer menerima pointer ke struktur POLICY_DNS_DOMAIN_INFO .

[out] Buffer

Penunjuk ke variabel yang menerima penunjuk ke struktur yang berisi informasi yang diminta. Jenis struktur tergantung pada nilai parameter InformationClass .

Ketika Anda tidak lagi memerlukan informasi, berikan penunjuk yang dikembalikan ke LsaFreeMemory.

Mengembalikan nilai

Jika fungsi LsaQueryInformationPolicy berhasil, nilai yang dikembalikan STATUS_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode NTSTATUS. Untuk informasi selengkapnya, lihat Nilai Pengembalian Fungsi Kebijakan LSA.

Anda dapat menggunakan fungsi LsaNtStatusToWinError untuk mengonversi kode NTSTATUS ke kode kesalahan Windows.

Keterangan

Untuk contoh yang menunjukkan pemanggilan fungsi ini lihat Mengelola Informasi Kebijakan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	ntsecapi.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll