LsaQueryForestTrustInformation-Funktion (ntsecapi.h)

Artikel
02/29/2024

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

Syntax

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

Parameter

[in] PolicyHandle

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

[in] TrustedDomainName

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

[out] ForestTrustInfo

Zeiger auf eine LSA_FOREST_TRUST_INFORMATION Struktur, die die Gesamtstrukturvertrauensinformationen für das TrustedDomain-Objekt zurückgibt, das durch den TrustedDomainName-Parameter 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, der einer der folgenden Werte oder einer der Rückgabewerte der LSA-Richtlinienfunktion sein kann.

Rückgabecode/-wert	BESCHREIBUNG
STATUS_INVALID_DOMAIN_ROLE	Der Vorgang ist nur auf dem primären Domänencontroller zulässig.
STATUS_INVALID_DOMAIN_STATE	Der Vorgang ist nur auf Domänencontrollern 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 Informationen zur Gesamtstrukturvertrauensstellung.

Hinweise

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecapi.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Freigeben über