Fungsi LsaSetInformationPolicy (ntsecapi.h)

Fungsi LsaSetInformationPolicy memodifikasi informasi dalam objek Policy .

Sintaks

NTSTATUS LsaSetInformationPolicy(
  [in] LSA_HANDLE               PolicyHandle,
  [in] POLICY_INFORMATION_CLASS InformationClass,
  [in] 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 diatur.

Nilai	Makna
PolicyAuditEventsInformation	Mengatur aturan audit sistem. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_SET_AUDIT_REQUIREMENTS. Parameter Buffer harus berupa penunjuk ke struktur POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation	Mengatur nama dan SID domain utama sistem. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_TRUST_ADMIN. Parameter Buffer harus menjadi penunjuk ke struktur POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation	Mengatur nama dan SID domain akun sistem. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_TRUST_ADMIN. Parameter Buffer harus menjadi penunjuk ke struktur POLICY_ACCOUNT_DOMAIN_INFO .
PolicyDnsDomainInformation	Mengatur informasi Sistem Nama Domain (DNS) tentang domain utama yang terkait dengan objek Kebijakan . Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_TRUST_ADMIN. Parameter Buffer harus berupa penunjuk ke struktur POLICY_DNS_DOMAIN_INFO .
PolicyLsaServerRoleInformation	Mengatur peran server LSA. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_SERVER_ADMIN. Parameter Buffer harus berupa penunjuk ke struktur POLICY_LSA_SERVER_ROLE_INFO . Mengubah peran server dari primer ke cadangan tidak berpengaruh (meskipun fungsi mengembalikan STATUS_SUCCESS). Mengubah peran server dari cadangan ke primer memerlukan operasi jaringan yang luas dan mungkin lambat.

[in] Buffer

Penunjuk ke struktur yang berisi informasi yang akan diatur. Jenis struktur tergantung pada nilai parameter InformationClass .

Mengembalikan nilai

Jika fungsi 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.

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

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_PRIMARY_DOMAIN_INFO