DS_SELECTION
The DS_SELECTION structure contains information about an object the user selected from an object picker dialog box. The DS_SELECTION_LIST structure contains an array of DS_SELECTION structures.
typedef struct _DS_SELECTION
{
PWSTR pwzName;
PWSTR pwzADsPath;
PWSTR pwzClass;
PWSTR pwzUPN;
VARIANT *pvarFetchedAttributes;
ULONG flScopeType;
} DS_SELECTION, *PDS_SELECTION;
Members
- pwzName
- Pointer to a null-terminated Unicode string containing the object's relative distinguished name (RDN).
- pwzADsPath
- Pointer to a null-terminated Unicode string containing the object's ADsPath. The format of this string depends on the flags specified in the flScope member of the DSOP_SCOPE_INIT_INFO structure for the scope from which this object was selected.
- pwzClass
- Pointer to a null-terminated Unicode string containing the value of the object's objectClass attribute.
- pwzUPN
- Pointer to a null-terminated Unicode string containing the object's userPrincipalName attribute value. If the object does not have a userPrincipalName value, pwzUPN points to an empty string (L"").
- pvarFetchedAttributes
- Pointer to an array of VARIANT structures. Each structure contains the value of an attribute of the selected object. The attributes retrieved are determined by the attribute names specified in the apwzAttributeNames member of the DSOP_INIT_INFO structure when you call the IDsObjectPicker::Initialize method. The order of attributes in the pvarFetchedAttributes array corresponds to the order of attribute names specified in the apwzAttributeNames array.
The dialog box may not be able to retrieve the requested attributes. Check the vt member of each VARIANT structure. If the attribute could not be retrieved, the vt member contains VT_EMPTY.
- flScopeType
- A DSOP_SCOPE_TYPE_* flag indicating the type of the scope from which this object was selected. For a list of DSOP_SCOPE_TYPE_* flags, see the flType member of the DSOP_SCOPE_INIT_INFO structure.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Objsel.h.
See Also
DS_SELECTION_LIST, DSOP_INIT_INFO, DSOP_SCOPE_INIT_INFO, IDsObjectPicker::Initialize, Object Picker Dialog Box Overview, Object Picker Dialog Box Structures, VARIANT