structure DS_SELECTION (objsel.h)

La structure DS_SELECTION contient des données sur un objet que l’utilisateur a sélectionné dans une boîte de dialogue sélecteur d’objets. La structure DS_SELECTION_LIST contient un tableau de structures DS_SELECTION .

Syntaxe

typedef struct _DS_SELECTION {
  PWSTR   pwzName;
  PWSTR   pwzADsPath;
  PWSTR   pwzClass;
  PWSTR   pwzUPN;
  VARIANT *pvarFetchedAttributes;
  ULONG   flScopeType;
} DS_SELECTION, *PDS_SELECTION;

Membres

pwzName

Pointeur vers une chaîne Unicode terminée par null qui contient le nom unique relatif (RDN) de l’objet.

pwzADsPath

Pointeur vers une chaîne Unicode terminée par null qui contient l’ADsPath de l’objet. Le format de cette chaîne dépend des indicateurs spécifiés dans le membre flScope de la structure DSOP_SCOPE_INIT_INFO pour l’étendue à partir de laquelle cet objet a été sélectionné.

pwzClass

Pointeur vers une chaîne Unicode terminée par null qui contient la valeur de l’attribut objectClass de l’objet.

pwzUPN

Pointeur vers une chaîne Unicode terminée par null qui contient la valeur de l’attribut userPrincipalName de l’objet. Si l’objet n’a pas de valeur userPrincipalName, pwzUPN pointe vers une chaîne vide (L" »).

pvarFetchedAttributes

Pointeur vers un tableau de structures VARIANT . Chaque VARIANT contient la valeur d’un attribut de l’objet sélectionné. Les attributs récupérés sont déterminés par les noms d’attributs spécifiés dans le membre apwzAttributeNames de la structure DSOP_INIT_INFO passé à la méthode IDsObjectPicker ::Initialize . L’ordre des attributs dans le tableau pvarFetchedAttributes correspond à l’ordre des noms d’attributs spécifié dans le tableau apwzAttributeNames .

La boîte de dialogue sélecteur d’objets peut ne pas être en mesure de récupérer les attributs demandés. Si l’attribut ne peut pas être récupéré, le membre vt de la structure VARIANT contient VT_EMPTY.

flScopeType

Contient une ou plusieurs des DSOP_SCOPE_TYPE_ qui indiquent le type d’étendue à partir duquel cet objet a été sélectionné. Pour plus d’informations et une liste d’indicateurs DSOP_SCOPE_TYPE_, consultez le membre flType de la structure DSOP_SCOPE_INIT_INFO.

Configuration requise

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

Voir aussi

DSOP_INIT_INFO

DSOP_SCOPE_INIT_INFO

DS_SELECTION_LIST

Sélecteur d’objets directory

IDsObjectPicker ::Initialize

VARIANTE