LsaSetForestTrustInformation-Funktion (ntsecapi.h)

  • Artikel

Die LsaSetForestTrustInformation-Funktion legt die Gesamtstrukturvertrauensinformationen für ein angegebenes TrustedDomain-Objekt der lokalen Sicherheitsautorität 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
);

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

[in] ForestTrustInfo

Zeiger auf eine LSA_FOREST_TRUST_INFORMATION Struktur, die die Informationen zur Gesamtstrukturvertrauensstellung enthält, die auf das vom TrustedDomainName-Parameter angegebene TrustedDomain-Objekt festgelegt werden sollen.

[in] CheckOnly

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

[out] CollisionInfo

Zeiger auf einen Zeiger auf eine LSA_FOREST_TRUST_COLLISION_INFORMATION Struktur, die Informationen zu aufgetretenen Kollisionen zurückgibt.

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_STATE
 Der Vorgang ist nur auf Domänencontrollern in der Stammdomäne zulässig.
STATUS_INVALID_DOMAIN_ROLE
 Der Vorgang ist nur auf dem primären Domänencontroller zulässig.

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