Fungsi LsaOpenPolicy (ntsecapi.h)

  • Artikel

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

Lihat juga

LSA_HANDLE

LSA_OBJECT_ATTRIBUTES

LSA_UNICODE_STRING

LsaClose

LsaNtStatusToWinError