LsaQueryForestTrustInformation-Funktion (ntsecapi.h)

Die Funktion LsaQueryForestTrustInformation ruft Gesamtstrukturvertrauensinformationen für das angegebene TrustedDomain-Objekt der lokalen Sicherheitszertifizierungsstelle ab.

Syntax

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

Die Parameter

[in] PolicyHandle

Ein Handle für das Policy-Objekt für das System.

[in] TrustedDomainName

Zeigen Sie auf eine LSA_UNICODE_STRING Struktur, die den Namen des TrustedDomain-Objekts enthält, für das Gesamtstrukturvertrauensinformationen abgerufen werden sollen.

[out] ForestTrustInfo

Zeigen Sie auf eine LSA_FOREST_TRUST_INFORMATION Struktur, die die Gesamtstrukturvertrauensinformationen für das trustedDomain-Objekt zurückgibt, das durch den Parameter TrustedDomainName angegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code, bei dem es sich um einen der folgenden Werte oder einen der Rückgabewerte der LSA-Richtlinienfunktion handeln kann.

Zurückgeben von Code/Wert	Description
STATUS_INVALID_DOMAIN_ROLE	Der Vorgang ist nur für den primären Domänencontroller zulässig.
STATUS_INVALID_DOMAIN_STATE	Der Vorgang ist nur für Domänencontroller in der Stammdomäne zulässig.
STATUS_NO_SUCH_DOMAIN	Das angegebene TrustedDomain-Objekt ist nicht vorhanden.
STATUS_NOT_FOUND	Das angegebene TrustedDomain-Objekt enthält keine Gesamtstrukturvertrauensinformationen.

Bemerkungen

Der Zugriff auf diese Funktion ist durch ein sicherungsfähiges Objekt geschützt.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Nicht unterstützt
Mindestanforderungen für unterstützte Server	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	ntsecapi.h
Library	Advapi32.lib
DLL	Advapi32.dll