structure DS_DOMAIN_TRUSTSW (dsgetdc.h)

Article
11/20/2024

La structure DS_DOMAIN_TRUSTS est utilisée avec la fonction DsEnumerateDomainTrusts pour contenir des données d’approbation pour un domaine.

Syntaxe

typedef struct _DS_DOMAIN_TRUSTSW {
#if ...
  wchar_t *NetbiosDomainName;
#if ...
  wchar_t *DnsDomainName;
#else
  LPWSTR  NetbiosDomainName;
#endif
#else
  LPWSTR  DnsDomainName;
#endif
  ULONG   Flags;
  ULONG   ParentIndex;
  ULONG   TrustType;
  ULONG   TrustAttributes;
#if ...
  PISID   DomainSid;
#else
  PSID    DomainSid;
#endif
  GUID    DomainGuid;
} DS_DOMAIN_TRUSTSW, *PDS_DOMAIN_TRUSTSW;

Membres

NetbiosDomainName

Pointeur vers une chaîne terminée par null qui contient le nom NetBIOS du domaine.

DnsDomainName

Pointeur vers une chaîne terminée par null qui contient le nom DNS du domaine. Ce membre peut être NULL.

Flags

Contient un ensemble d’indicateurs qui spécifient plus de données sur l’approbation de domaine. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

DS_DOMAIN_IN_FOREST (1 (0x1))

Le domaine représenté par cette structure est membre de la même forêt que le serveur spécifié dans le paramètre ServerName de la fonction DsEnumerateDomainTrusts.

DS_DOMAIN_DIRECT_OUTBOUND (2 (0x2))

Le domaine représenté par cette structure est directement approuvé par le domaine spécifié dans le paramètre ServerName de la fonction DsEnumerateDomainTrusts est membre.

DS_DOMAIN_TREE_ROOT (4 (0x4))

Le domaine représenté par cette structure est la racine d’une arborescence et d’un membre de la même forêt que le serveur spécifié dans le paramètre ServerName de la fonction DsEnumerateDomainTrusts.

DS_DOMAIN_PRIMARY (8 (0x8))

Le domaine représenté par cette structure est le domaine principal du serveur spécifié dans le paramètre ServerName de la fonction DsEnumerateDomainTrusts.

DS_DOMAIN_NATIVE_MODE (16 (0x10))

Le domaine représenté par cette structure s’exécute en mode natif Windows 2000.

DS_DOMAIN_DIRECT_INBOUND (32 (0x20))

Le domaine représenté par cette structure approuve directement le domaine que le serveur spécifié dans le paramètre ServerName de la fonction DsEnumerateDomainTrusts est membre.

ParentIndex

Contient l’index dans le tableau Domains retourné par la fonction DsEnumerateDomainTrusts qui correspond au domaine parent du domaine représenté par cette structure. Ce membre est valide uniquement si toutes les conditions suivantes sont remplies :

L’indicateur DS_DOMAIN_IN_FOREST a été spécifié dans le paramètre flags de la fonction DsEnumerateDomainTrusts.
Les indicateurs membre de cette structure ne contiennent pas l’indicateur DS_DOMAIN_TREE_ROOT.

TrustType

Contient une valeur qui indique le type d’approbation représenté par cette structure. Les valeurs possibles pour ce membre sont documentées dans le TrustType membre de la structure TRUSTED_DOMAIN_INFORMATION_EX.

TrustAttributes

Contient une valeur qui indique les attributs de l’approbation représentée par cette structure. Les valeurs possibles pour ce membre sont documentées dans la TrustAttribute membre de la structure TRUSTED_DOMAIN_INFORMATION_EX.

DomainSid

Contient l’identificateur de sécurité du domaine représenté par cette structure.

DomainGuid

Contient le GUID du domaine représenté par cette structure.

Remarques

Note

L’en-tête dsgetdc.h définit DS_DOMAIN_TRUSTS 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. 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
d’en-tête	dsgetdc.h

Voir aussi

structures de service d’annuaire

DsEnumerateDomainTrusts

TRUSTED_DOMAIN_INFORMATION_EX

Partager via