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.

Bemerkungen

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

Anforderungen