Fungsi LsaQueryForestTrustInformation (ntsecapi.h)

  • Artikel

Fungsi LsaQueryForestTrustInformation mengambil informasi kepercayaan forest untuk objek TrustedDomainOtoritas Keamanan Lokal yang ditentukan.

Sintaks

NTSTATUS LsaQueryForestTrustInformation(
  [in]  LSA_HANDLE                    PolicyHandle,
  [in]  PLSA_UNICODE_STRING           TrustedDomainName,
  [out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

Parameter

[in] PolicyHandle

Handel ke objek Kebijakan untuk sistem.

[in] TrustedDomainName

Arahkan ke struktur LSA_UNICODE_STRING yang berisi nama objek TrustedDomain untuk mengambil informasi kepercayaan hutan.

[out] ForestTrustInfo

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

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_ROLE
 Operasi ini hanya legal pada pengendali domain utama.
STATUS_INVALID_DOMAIN_STATE
 Operasi ini hanya legal pada pengendali domain di domain akar.
STATUS_NO_SUCH_DOMAIN
 Objek TrustedDomain yang ditentukan tidak ada.
STATUS_NOT_FOUND
 Objek TrustedDomain yang ditentukan tidak berisi informasi kepercayaan hutan.

Keterangan

Akses ke fungsi ini dilindungi oleh objek yang dapat diamankan.

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