DsEnumerateDomainTrustsA-Funktion (dsgetdc.h)
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 |