Share via

DsEnumerateDomainTrustsA-Funktion (dsgetdc.h)

  • Artikel

Die DsEnumerateDomainTrusts-Funktion ruft Domänenvertrauensdaten für eine angegebene Domäne ab.

Syntax

DSGETDCAPI DWORD DsEnumerateDomainTrustsA(
  [in, optional] LPSTR              ServerName,
  [in]           ULONG              Flags,
  [out]          PDS_DOMAIN_TRUSTSA *Domains,
  [out]          PULONG             DomainCount
);

Parameter

[in, optional] ServerName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen eines Computers in der Domäne angibt, für den die Vertrauensinformationen abgerufen werden sollen. Wenn dieser Parameter NULL ist, wird der Name des lokalen Computers verwendet. Der Aufrufer muss ein authentifizierter Benutzer in dieser Domäne sein.

Wenn es sich bei diesem Computer um einen Domänencontroller handelt, gibt diese Funktion die Vertrauensdaten sofort zurück. Wenn dieser Computer kein Domänencontroller ist, ruft diese Funktion die Vertrauensdaten aus zwischengespeicherten Daten ab, wenn die zwischengespeicherten Daten nicht abgelaufen sind. Wenn die zwischengespeicherten Daten abgelaufen sind, ruft diese Funktion die Vertrauensdaten von einem Domänencontroller in der Domäne ab, in der dieser Computer Mitglied ist, und aktualisiert den Cache. Die zwischengespeicherten Daten laufen automatisch nach fünf Minuten ab.

[in] Flags

Enthält eine Reihe von Flags, die bestimmt, welche Domäne enumeriert werden soll. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

DS_DOMAIN_DIRECT_INBOUND

Listen Sie Domänen auf, die der Domäne, die ServerName als Mitglied besitzt, direkt vertrauen.

DS_DOMAIN_DIRECT_OUTBOUND

Listen Sie Domänen auf, die von der Domäne mit ServerName als Mitglied direkt vertrauenswürdig sind.

DS_DOMAIN_IN_FOREST

Enumerate domains that are a member of the same forest that has ServerName as a member.

DS_DOMAIN_NATIVE_MODE

Auflisten von Domänen, in denen die primäre Domäne im einheitlichen Modus von Windows 2000 ausgeführt wird.

DS_DOMAIN_PRIMARY

Listen Sie Domänen auf, die die primäre Domäne der Domäne sind, die ServerName als Mitglied aufweist.

DS_DOMAIN_TREE_ROOT

Listen Sie Domänen auf, die sich im Stammverzeichnis der Gesamtstruktur befinden, die ServerName als Mitglied aufweist.

[out] Domains

Zeiger auf einen PDS_DOMAIN_TRUSTS Wert, der ein Array von DS_DOMAIN_TRUSTS-Strukturen empfängt. Jede Struktur in diesem Array enthält Vertrauensdaten zu einer Domäne. Der Aufrufer muss diesen Arbeitsspeicher freigeben, wenn er nicht mehr benötigt wird, indem Er NetApiBufferFree aufruft.

[out] DomainCount

Zeiger auf einen ULONG-Wert , der die Anzahl der im Domänen-Array zurückgegebenen Elemente empfängt.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn erfolgreich oder andernfalls ein Win32-Fehlercode. Mögliche Fehlercodes sind die in der folgenden Liste aufgeführten.

Hinweise

Hinweis

Der Dsgetdc.h-Header definiert DsEnumerateDomainTrusts als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile dsgetdc.h
Bibliothek Netapi32.lib
DLL Netapi32.dll

Weitere Informationen

DS_DOMAIN_TRUSTS

Verzeichnisdienstfunktionen

NetApiBufferFree