DsEnumerateDomainTrustsA, fonction (dsgetdc.h)

  • Article

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

Voir aussi

DS_DOMAIN_TRUSTS

Fonctions de service d’annuaire

NetApiBufferFree