DsEnumerateDomainTrustsA-Funktion (dsgetdc.h)
Die funktion DsEnumerateDomainTrusts 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
Zeigen Sie auf eine mit Null beendete 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 nach fünf Minuten automatisch 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
Aufzählen von Domänen, die der Domäne direkt vertrauen, die ServerName- als Mitglied aufweist.
DS_DOMAIN_DIRECT_OUTBOUND
Aufzählen von Domänen, die direkt von der Domäne vertrauenswürdig sind, die ServerName als Mitglied hat.
DS_DOMAIN_IN_FOREST
Aufzählen von Domänen, die Mitglied derselben Gesamtstruktur sind, die ServerName- als Mitglied aufweist.
DS_DOMAIN_NATIVE_MODE
Auflisten von Domänen, in denen die primäre Domäne im nativen Windows 2000-Modus ausgeführt wird.
DS_DOMAIN_PRIMARY
Aufzählen von Domänen, die die primäre Domäne der Domäne sind, die ServerName als Mitglied hat.
DS_DOMAIN_TREE_ROOT
Aufzählen von Domänen, die sich am Stamm der Gesamtstruktur befinden, die ServerName- als Mitglied aufweist.
[out] Domains
Zeigen Sie 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 Speicher freigeben, wenn er nicht mehr benötigt wird, indem NetApiBufferFree-aufgerufen wird.
[out] DomainCount
Zeiger auf einen ULONG--Wert, der die Anzahl der im Domains Array zurückgegebenen Elemente empfängt.
Rückgabewert
Gibt ERROR_SUCCESS zurück, wenn der Fehlercode "Win32" erfolgreich war oder andernfalls ein Win32-Fehlercode ausgeführt wurde. Mögliche Fehlercodes sind die in der folgenden Liste aufgeführten Fehlercodes.
Bemerkungen
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | dsgetdc.h |
| Library | Netapi32.lib |
| DLL- | Netapi32.dll |