LsaEnumerateTrustedDomains-Funktion (ntsecapi.h)

Die LsaEnumerateTrustedDomains-Funktion ruft die Namen und SIDs von Domänen ab, die vertrauenswürdig sind, um Anmeldeinformationen zu authentifizieren. LsaEnumerateTrustedDomains ist für die Verwendung auf Systemen mit Windows NT 4.0 oder früheren Versionen von Windows NT vorgesehen. Verwenden Sie DsEnumerateDomainTrusts für andere Zwecke der Vertrauensenumeration. Insbesondere kann LsaEnumerateTrustedDomains nur verwendet werden, wenn mindestens eine der folgenden Werte zutrifft:

• Auf dem aufrufenden System wird Windows NT 4.0 oder eine frühere Version von Windows NT ausgeführt.
• Das Zielsystem (angegeben mit dem Parameter PolicyHandle ) ist ein Domänencontroller, auf dem Windows NT 4.0 oder eine frühere Version ausgeführt wird.
• Das aufrufende System führt Windows NT 4.0 oder eine frühere Version aus und ist kein Domänencontroller, und das Zielsystem ist ein Domänencontroller in der Domäne des aufrufenden Systems. Auf dem Zielsystem kann eine beliebige Version von Windows NT ausgeführt werden, einschließlich Windows 2000 und Windows XP.

Syntax

NTSTATUS LsaEnumerateTrustedDomains(
  [in]  LSA_HANDLE              PolicyHandle,
  [in]  PLSA_ENUMERATION_HANDLE EnumerationContext,
  [out] PVOID                   *Buffer,
  [in]  ULONG                   PreferedMaximumLength,
  [out] PULONG                  CountReturned
);

Parameter

[in] PolicyHandle

Ein Handle für ein Policy-Objekt . Das Handle muss über das zugriffsrecht POLICY_VIEW_LOCAL_INFORMATION verfügen. Weitere Informationen finden Sie unter Öffnen eines Richtlinienobjekthandles.

[in] EnumerationContext

Zeiger auf ein Enumerationshandle, mit dem Sie mehrere Aufrufe ausführen können, um alle vertrauenswürdigen Domänen aufzulisten. Beim ersten Aufruf von LsaEnumerateTrustedDomains muss EnumerationContext auf eine Variable verweisen, die mit null initialisiert wurde. Bei nachfolgenden Aufrufen von LsaEnumerateTrustedDomains muss EnumerationContext auf das Vom vorherigen Aufruf zurückgegebene Enumerationshandle verweisen.

[out] Buffer

Empfängt einen Zeiger auf ein Array von LSA_TRUST_INFORMATION Strukturen, die die Namen und SIDs einer oder mehrerer vertrauenswürdiger Domänen enthalten.

Wenn Sie die Informationen nicht mehr benötigen, übergeben Sie den zurückgegebenen Zeiger an LsaFreeMemory.

[in] PreferedMaximumLength

Gibt die bevorzugte maximale Größe des zurückgegebenen Puffers in Bytes an. Diese Informationen sind ungefähr; Die tatsächliche Anzahl der zurückgegebenen Bytes kann größer als dieser Wert sein.

[out] CountReturned

Zeiger auf eine Variable, die die Anzahl der im Buffer-Parameter zurückgegebenen Elemente empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert einer der folgenden NTSTATUS-Werte.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code. Weitere Informationen finden Sie unter Rückgabewerte der LSA-Richtlinienfunktion.

Sie können die LsaNtStatusToWinError-Funktion verwenden, um den NTSTATUS-Code in einen Windows-Fehlercode zu konvertieren.

Hinweise

Für Domänen mit Domänencontrollern, auf denen nur Windows NT 4.0 oder frühere Versionen von Windows NT ausgeführt werden, gibt LsaEnumerateTrustedDomains eine Liste aller vertrauenswürdigen Domänen zurück. In Releases von Windows NT bis einschließlich Release 4.0 sind alle vertrauenswürdigen Domänen direkt vertrauenswürdig.

In Windows XP- und Windows 2000-Domänen im gemischten Modus wird auf Domänencontrollern möglicherweise Windows XP, Windows 2000 oder Windows NT ausgeführt. Daher werden in Domänen im gemischten Modus einige vertrauenswürdige Domänen direkt vertrauenswürdig und andere indirekt vertrauenswürdig. Beim Aufzählen der vertrauenswürdigen Domänen eines Systems in einer Domäne im gemischten Modus gibt LsaEnumerateTrustedDomains nur direkt vertrauenswürdige Domänen zurück.

Im Gegensatz dazu enthalten Windows XP- und Windows 2000-Domänen im einheitlichen Modus nur Windows 2000-Domänencontroller, auch wenn mitglieder in der Domäne vorhanden sind, in der Windows NT 4.0 oder frühere Versionen ausgeführt werden. Beim Aufzählen der vertrauenswürdigen Domänen eines Systems in einer Windows XP- und Windows 2000-Domäne im einheitlichen Modus gibt LsaEnumerateTrustedDomains sowohl direkt vertrauenswürdige als auch indirekt vertrauenswürdige Domänen zurück.

Das Abrufen aller Vertrauensinformationen erfordert möglicherweise mehr als einen einzelnen LsaEnumerateTrustedDomains-Aufruf . Sie können den EnumerationContext-Parameter verwenden, um mehrere Aufrufe wie folgt auszuführen: Legen Sie beim ersten Aufruf die Variable, auf die enumerationContext verweist, auf Null fest. Wenn LsaEnumerateTrustedDomains STATUS_SUCCESS oder STATUS_MORE_ENTRIES zurückgibt, rufen Sie die Funktion erneut auf, und übergeben Sie dabei den Vom vorherigen Aufruf zurückgegebenen EnumerationContext-Wert . Die Enumeration ist abgeschlossen, wenn die Funktion STATUS_NO_MORE_ENTRIES zurückgibt.

Anforderungen

Weitere Informationen

LSA_TRUST_INFORMATION

LsaEnumerateTrustedDomainsEx

LsaFreeMemory

LsaOpenPolicy