DsEnumerateDomainTrustsA, fonction (dsgetdc.h)
La fonction DsEnumerateDomainTrusts obtient des données d’approbation de domaine pour un domaine spécifié.
Syntaxe
DSGETDCAPI DWORD DsEnumerateDomainTrustsA(
[in, optional] LPSTR ServerName,
[in] ULONG Flags,
[out] PDS_DOMAIN_TRUSTSA *Domains,
[out] PULONG DomainCount
);
Paramètres
[in, optional] ServerName
Pointeur vers une chaîne terminée par null qui spécifie le nom d’un ordinateur du domaine pour lequel obtenir les informations d’approbation. Si ce paramètre est NULL, le nom de l’ordinateur local est utilisé. L’appelant doit être un utilisateur authentifié dans ce domaine.
Si cet ordinateur est un contrôleur de domaine, cette fonction retourne immédiatement les données d’approbation. Si cet ordinateur n’est pas un contrôleur de domaine, cette fonction obtient les données d’approbation des données mises en cache si les données mises en cache n’ont pas expiré. Si les données mises en cache ont expiré, cette fonction obtient les données d’approbation d’un contrôleur de domaine dans le domaine dont cet ordinateur est membre et met à jour le cache. Les données mises en cache expirent automatiquement après cinq minutes.
[in] Flags
Contient un ensemble d’indicateurs qui déterminent les approbations de domaine à énumérer. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.
DS_DOMAIN_DIRECT_INBOUND
Énumérez les domaines qui approuvent directement le domaine qui a ServerName en tant que membre.
DS_DOMAIN_DIRECT_OUTBOUND
Énumérez les domaines directement approuvés par le domaine qui a ServerName en tant que membre.
DS_DOMAIN_IN_FOREST
Énumérez les domaines qui sont membres de la même forêt qui a ServerName en tant que membre.
DS_DOMAIN_NATIVE_MODE
Énumérez les domaines dans lesquels le domaine principal s’exécute en mode natif Windows 2000.
DS_DOMAIN_PRIMARY
Énumérez les domaines qui sont le domaine principal du domaine qui a Nom_serveur en tant que membre.
DS_DOMAIN_TREE_ROOT
Énumérez les domaines qui se trouvent à la racine de la forêt qui a ServerName en tant que membre.
[out] Domains
Pointeur vers une valeur PDS_DOMAIN_TRUSTS qui reçoit un tableau de structures DS_DOMAIN_TRUSTS. Chaque structure de ce tableau contient des données d’approbation sur un domaine. L’appelant doit libérer cette mémoire lorsqu’elle n’est plus nécessaire en appelant NetApiBufferFree.
[out] DomainCount
Pointeur vers une valeur ULONG
Valeur de retour
Retourne ERROR_SUCCESS en cas de réussite ou de code d’erreur Win32 dans le cas contraire. Les codes d’erreur possibles incluent ceux répertoriés dans la liste suivante.
Remarques
Note
L’en-tête dsgetdc.h définit DsEnumerateDomainTrusts comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| serveur minimum pris en charge | Windows Server 2008 |
| plateforme cible | Windows |
| d’en-tête | dsgetdc.h |
| bibliothèque | Netapi32.lib |
| DLL | Netapi32.dll |