Platform SDK: Active Directory, ADSI, and Directory Services

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.

Requirements

  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