Fungsi LsaOpenPolicy (ntsecapi.h)
Fungsi LsaOpenPolicy membuka handel ke objek Policy pada sistem lokal atau jarak jauh.
Anda harus menjalankan proses "Sebagai Administrator" agar panggilan tidak gagal dengan ERROR_ACCESS_DENIED.
Sintaks
NTSTATUS LsaOpenPolicy(
[in] PLSA_UNICODE_STRING SystemName,
[in] PLSA_OBJECT_ATTRIBUTES ObjectAttributes,
[in] ACCESS_MASK DesiredAccess,
[in, out] PLSA_HANDLE PolicyHandle
);
Parameter
[in] SystemName
Penunjuk ke struktur LSA_UNICODE_STRING yang berisi nama sistem target. Nama dapat memiliki formulir "ComputerName" atau "\\ComputerName". Jika parameter ini NULL, fungsi akan membuka objek Policy pada sistem lokal.
[in] ObjectAttributes
Penunjuk ke struktur LSA_OBJECT_ATTRIBUTES yang menentukan atribut koneksi. Anggota struktur tidak digunakan; menginisialisasinya ke NULL atau nol.
[in] DesiredAccess
ACCESS_MASK yang menentukan hak akses yang diminta. Fungsi gagal jika DACL sistem target tidak mengizinkan pemanggil akses yang diminta. Untuk menentukan hak akses yang Anda butuhkan, lihat dokumentasi untuk fungsi LSA yang ingin Anda gunakan penanganan kebijakannya.
[in, out] PolicyHandle
Penunjuk ke variabel LSA_HANDLE yang menerima handel ke objek Policy .
Ketika Anda tidak lagi membutuhkan handel ini, teruskan ke fungsi LsaClose untuk menutupnya.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan STATUS_SUCCESS.
Jika fungsi gagal, fungsi akan mengembalikan 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 mengelola kebijakan keamanan lokal sistem lokal atau jarak jauh, Anda harus memanggil fungsi LsaOpenPolicy untuk membuat sesi dengan subsistem LSA sistem tersebut. LsaOpenPolicy terhubung ke LSA sistem target dan mengembalikan handel ke objek Policy sistem tersebut. Anda dapat menggunakan handel ini dalam panggilan fungsi LSA berikutnya untuk mengelola informasi kebijakan keamanan lokal dari sistem target.
Untuk contoh yang menunjukkan pemanggilan fungsi ini lihat Membuka Gagang Objek 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 |