Fungsi LsaGetAppliedCAPIDs (ntlsa.h)
Fungsi LsaGetAppliedCAPIDs mengembalikan array pengidentifikasi kebijakan akses pusat (CAPs) dari semua OS yang diterapkan pada komputer tertentu.
Sintaks
NTSTATUS LsaGetAppliedCAPIDs(
[in, optional] PLSA_UNICODE_STRING SystemName,
[out] PSID **CAPIDs,
[out] PULONG CAPIDCount
);
Parameter
[in, optional] SystemName
Penunjuk ke struktur LSA_UNICODE_STRING yang berisi nama komputer tertentu. Nama dapat memiliki bentuk "ComputerName" atau "\ComputerName". Jika parameter ini NULL, maka fungsi mengembalikan CAPID komputer lokal.
[out] CAPIDs
Penunjuk ke variabel yang menerima array pointer ke KAPID yang mengidentifikasi CAPs yang tersedia di komputer yang ditentukan. Setelah Anda selesai menggunakan CAPID, panggil fungsi LsaFreeMemory pada setiap elemen dalam array dan seluruh array.
[out] CAPIDCount
Penunjuk ke variabel yang menerima jumlah CAP yang tersedia di komputer yang ditentukan. Array yang dikembalikan dalam parameter CAPID berisi jumlah elemen yang sama dengan parameter CAPIDCount .
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah STATUS_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu Nilai Pengembalian Fungsi Kebijakan LSA. Anda dapat menggunakan fungsi LsaNtStatusToWinError untuk mengonversi kode NTSTATUS ke kode kesalahan Windows.
Keterangan
Untuk detail spesifik tentang kebijakan akses pusat, Anda dapat mengkueri atribut objek kebijakan akses pusat di Direktori Aktif pada pengendali domain komputer yang ditentukan. Cari objek yang atribut msAuthz-CentralAccessPolicyID-nya cocok dengan salah satu CAPID yang dikembalikan.
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 | ntlsa.h |
| Pustaka | Advapi32.lib |
| DLL | Advapi32.dll |