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 un caractère Null qui spécifie le nom d’un ordinateur dans le domaine pour lequel obtenir les informations d’approbation. Si ce paramètre a la valeur 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 au bout de cinq minutes.
[in] Flags
Contient un ensemble d’indicateurs qui détermine 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 comme membre.
DS_DOMAIN_DIRECT_OUTBOUND
Énumérez les domaines directement approuvés par le domaine qui a ServerName comme membre.
DS_DOMAIN_IN_FOREST
Énumérez les domaines qui sont membres de la même forêt qui a ServerName comme membre.
DS_DOMAIN_NATIVE_MODE
Énumérez les domaines où 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 ServerName comme membre.
DS_DOMAIN_TREE_ROOT
Énumérez les domaines qui se trouvent à la racine de la forêt qui a ServerName comme 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 quand elle n’est plus nécessaire en appelant NetApiBufferFree.
[out] DomainCount
Pointeur vers une valeur ULONG qui reçoit le nombre d’éléments retournés dans le tableau Domains .
Valeur retournée
Retourne ERROR_SUCCESS en cas de réussite ou un code d’erreur Win32 dans le cas contraire. Les codes d’erreur possibles incluent ceux répertoriés dans la liste suivante.
Remarques
Notes
L’en-tête dsgetdc.h définit DsEnumerateDomainTrusts en tant qu’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. La combinaison 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.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista |
Serveur minimal pris en charge | Windows Server 2008 |
Plateforme cible | Windows |
En-tête | dsgetdc.h |
Bibliothèque | Netapi32.lib |
DLL | Netapi32.dll |