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 |