LsaSetForestTrustInformation-Funktion (ntsecapi.h)

Die Funktion LsaSetForestTrustInformation legt die Vertrauensinformationen der Gesamtstruktur für ein angegebenes TrustedDomain-Objekt der lokalen Sicherheitszertifizierungsstelle fest.

Syntax

NTSTATUS LsaSetForestTrustInformation(
  [in]  LSA_HANDLE                              PolicyHandle,
  [in]  PLSA_UNICODE_STRING                     TrustedDomainName,
  [in]  PLSA_FOREST_TRUST_INFORMATION           ForestTrustInfo,
  [in]  BOOLEAN                                 CheckOnly,
  [out] PLSA_FOREST_TRUST_COLLISION_INFORMATION *CollisionInfo
);

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, auf das die durch den ForestTrustInfo-Parameter angegebenen Gesamtstrukturvertrauensinformationen festgelegt werden sollen.

[in] ForestTrustInfo

Zeigen Sie auf eine LSA_FOREST_TRUST_INFORMATION Struktur, die die Gesamtstrukturvertrauensinformationen enthält, die auf das trustedDomain-Objekt festgelegt werden sollen, das durch den Parameter TrustedDomainName angegeben wird.

[in] CheckOnly

Boolescher Wert, der angibt, ob Änderungen am TrustedDomain-Objekt beibehalten werden. Wenn dieser Wert WAHR ist, überprüft diese Funktion auf Kollisionen mit den angegebenen Parametern, legt jedoch die durch den ForestTrustInfo-Parameter angegebenen Gesamtstrukturvertrauensinformationen nicht auf das trustedDomain-Objekt fest, das vom Parameter TrustedDomainName angegeben wird. Wenn dieser Wert FALSCH ist, werden die Vertrauensinformationen der Gesamtstruktur auf das TrustedDomain-Objekt festgelegt.

[out] CollisionInfo

Zeigen Sie auf einen Zeiger auf eine LSA_FOREST_TRUST_COLLISION_INFORMATION Struktur, die Informationen zu kollisionen zurückgibt, die aufgetreten sind.

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.

Anforderungen