énumération DS_NAME_FORMAT (ntdsapi.h)

  • Article

L’énumération DS_NAME_FORMAT fournit des formats à utiliser pour les noms d’entrée et de sortie pour la fonction DsCrackNames.

Syntax

typedef enum {
  DS_UNKNOWN_NAME = 0,
  DS_FQDN_1779_NAME = 1,
  DS_NT4_ACCOUNT_NAME = 2,
  DS_DISPLAY_NAME = 3,
  DS_UNIQUE_ID_NAME = 6,
  DS_CANONICAL_NAME = 7,
  DS_USER_PRINCIPAL_NAME = 8,
  DS_CANONICAL_NAME_EX = 9,
  DS_SERVICE_PRINCIPAL_NAME = 10,
  DS_SID_OR_SID_HISTORY_NAME = 11,
  DS_DNS_DOMAIN_NAME = 12
} DS_NAME_FORMAT;

Constantes

 
DS_UNKNOWN_NAME
Valeur : 0
Indique que le nom utilise un type de nom inconnu. Ce format peut avoir un impact sur les performances, car il force le serveur à tenter de faire correspondre tous les
Formats. Utilisez cette valeur uniquement si le format d’entrée est inconnu.
DS_FQDN_1779_NAME
Valeur : 1
Indique que le nom unique complet est utilisé. Par exemple :

CN=someone,OU=Users,DC=Engineering,DC=Fabrikam,DC=Com
DS_NT4_ACCOUNT_NAME
Valeur : 2
Indique un nom de compte Windows NT 4.0. Par exemple :

Ingénierie\quelqu’un

La version de domaine uniquement comprend deux barres obliques inverses de fin (\).
DS_DISPLAY_NAME
Valeur : 3
Indique un nom d’affichage convivial, par exemple Jeff Smith. Le nom d’affichage n’est pas nécessairement le même que le nom unique relatif (RDN).
DS_UNIQUE_ID_NAME
Valeur : 6
Indique une chaîne GUID que la fonction IIDFromString retourne. Par exemple :

{4fa050f0-f561-11cf-bdd9-00aa003a77b6}
DS_CANONICAL_NAME
Valeur : 7
Indique un nom canonique complet. Par exemple :

engineering.fabrikam.com/software/someone

La version de domaine uniquement comprend une barre oblique de fin (/).
DS_USER_PRINCIPAL_NAME
Valeur : 8
Indique qu’il utilise le nom d’utilisateur principal (UPN). Par exemple :

someone@engineering.fabrikam.com
DS_CANONICAL_NAME_EX
Valeur : 9
Cet élément est identique à DS_CANONICAL_NAME sauf que la barre oblique la plus à droite (/) est remplacée par un caractère de nouvelle ligne (\n), même dans un cas de domaine uniquement. Par exemple :

engineering.fabrikam.com/software\nquelqu’un
DS_SERVICE_PRINCIPAL_NAME
Valeur : 10
Indique qu’il utilise un nom de principal de service généralisé. Par exemple :

Www/www.fabrikam.com@fabrikam.com
DS_SID_OR_SID_HISTORY_NAME
Valeur : 11
Indique un identificateur de sécurité (SID) pour l’objet. Il peut s’agir du SID actuel ou d’un SID de l’historique SID de l’objet. La chaîne SID peut utiliser la représentation de chaîne standard d’un SID ou l’une des constantes de chaîne définies dans Sddl.h. Pour plus d’informations sur la conversion d’un SID binaire en chaîne SID, consultez
Chaînes SID. Voici un exemple de chaîne SID :

S-1-5-21-397955417-626881126-18844144-501
DS_DNS_DOMAIN_NAME
Valeur : 12
Non pris en charge par les API de service d’annuaire (DS).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
En-tête ntdsapi.h

Voir aussi

DsCrackNames

Énumérations dans services de domaine Active Directory