Fungsi LsaQueryForestTrustInformation (ntsecapi.h)

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

Syntax

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

Parameter-parameternya

[in] PolicyHandle

Handel ke objek Kebijakan untuk sistem.

[in] TrustedDomainName

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

[out] ForestTrustInfo

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

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah 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	Description
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.

Komentar

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]
Platform Target	Windows
Header	ntsecapi.h
Library	Advapi32.lib
DLL	Advapi32.dll