Fungsi LsaSetTrustedDomainInformation (ntsecapi.h)

Fungsi LsaSetTrustedDomainInformation memodifikasi informasi objek Policy tentang domain tepercaya.

Sintaks

NTSTATUS LsaSetTrustedDomainInformation(
  [in] LSA_HANDLE                PolicyHandle,
  [in] PSID                      TrustedDomainSid,
  [in] TRUSTED_INFORMATION_CLASS InformationClass,
  [in] PVOID                     Buffer
);

Parameter

[in] PolicyHandle

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

[in] TrustedDomainSid

Arahkan ke SID domain tepercaya yang informasinya dimodifikasi. Jika parameter InformationClass diatur ke TrustedDomainNameInformation, parameter ini harus menunjuk ke SID domain untuk ditambahkan ke daftar domain tepercaya.

[in] InformationClass

Menentukan salah satu nilai berikut dari jenis enumerasi TRUSTED_INFORMATION_CLASS . Nilai menunjukkan jenis informasi yang ditetapkan.

Nilai	Makna
TrustedDomainNameInformation	Jika domain yang ditentukan tidak ada dalam daftar domain tepercaya, fungsi LsaSetTrustedDomainInformation menambahkannya. Parameter TrustedDomainSid harus menjadi SID domain yang akan ditambahkan. Parameter Buffer harus berupa penunjuk ke struktur TRUSTED_DOMAIN_NAME_INFO yang berisi nama domain yang akan ditambahkan. Jika domain yang ditentukan sudah ada dalam daftar domain tepercaya, fungsi akan gagal.
TrustedPosixOffsetInformation	Mengatur nilai yang digunakan untuk menghasilkan pengidentifikasi pengguna dan grup Posix. Parameter Buffer harus berupa penunjuk ke struktur TRUSTED_POSIX_OFFSET_INFO .
TrustedPasswordInformation	Mengatur kata sandi untuk domain tepercaya. Parameter Buffer harus menjadi penunjuk ke struktur TRUSTED_PASSWORD_INFO yang berisi kata sandi lama dan baru untuk domain yang ditentukan. Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_CREATE_SECRET. String kata sandi lama bisa NULL.

[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

LsaDeleteTrustedDomain

LsaQueryTrustedDomainInfo

TRUSTED_DOMAIN_NAME_INFO

TRUSTED_INFORMATION_CLASS

TRUSTED_PASSWORD_INFO

TRUSTED_POSIX_OFFSET_INFO