Fungsi LsaSetForestTrustInformation (ntsecapi.h)

  • Artikel

Fungsi LsaSetForestTrustInformation menetapkan informasi kepercayaan forest untuk objek TrustedDomainOtoritas Keamanan Lokal tertentu.

Sintaks

NTSTATUS LsaSetForestTrustInformation(
  [in]  LSA_HANDLE                              PolicyHandle,
  [in]  PLSA_UNICODE_STRING                     TrustedDomainName,
  [in]  PLSA_FOREST_TRUST_INFORMATION           ForestTrustInfo,
  [in]  BOOLEAN                                 CheckOnly,
  [out] PLSA_FOREST_TRUST_COLLISION_INFORMATION *CollisionInfo
);

Parameter

[in] PolicyHandle

Handel ke objek Kebijakan untuk sistem.

[in] TrustedDomainName

Penunjuk ke struktur LSA_UNICODE_STRING yang berisi nama objek TrustedDomain untuk mengatur informasi kepercayaan forest yang ditentukan oleh parameter ForestTrustInfo .

[in] ForestTrustInfo

Arahkan ke struktur LSA_FOREST_TRUST_INFORMATION yang berisi informasi kepercayaan forest untuk diatur ke objek TrustedDomain yang ditentukan oleh parameter TrustedDomainName .

[in] CheckOnly

Nilai Boolean yang menentukan apakah perubahan pada objek TrustedDomain dipertahankan. Jika nilai ini TRUE, fungsi ini akan memeriksa tabrakan dengan parameter yang ditentukan tetapi tidak akan mengatur informasi kepercayaan forest yang ditentukan oleh parameter ForestTrustInfo ke objek TrustedDomain yang ditentukan oleh parameter TrustedDomainName . Jika nilai ini FALSE, informasi kepercayaan forest akan diatur ke objek TrustedDomain .

[out] CollisionInfo

Penunjuk ke penunjuk ke struktur LSA_FOREST_TRUST_COLLISION_INFORMATION yang mengembalikan informasi tentang tabrakan apa pun yang terjadi.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan STATUS_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode NTSTATUS, yang dapat menjadi salah satu nilai berikut atau salah satu Nilai Pengembalian Fungsi Kebijakan LSA.

Mengembalikan kode/nilai Deskripsi
STATUS_INVALID_DOMAIN_STATE
 Operasi ini hanya legal pada pengendali domain di domain akar.
STATUS_INVALID_DOMAIN_ROLE
 Operasi ini hanya legal pada pengendali domain utama.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tidak ada yang didukung
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header ntsecapi.h
Pustaka Advapi32.lib
DLL Advapi32.dll