estructura DS_SELECTION (objsel.h)

Artículo
08/25/2023

La estructura de DS_SELECTION contiene datos sobre un objeto que el usuario seleccionó en un cuadro de diálogo del selector de objetos. La estructura DS_SELECTION_LIST contiene una matriz de estructuras de DS_SELECTION .

Sintaxis

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

Miembros

pwzName

Puntero a una cadena Unicode terminada en null que contiene el nombre distintivo relativo (RDN) del objeto.

pwzADsPath

Puntero a una cadena Unicode terminada en null que contiene ADsPath del objeto. El formato de esta cadena depende de las marcas especificadas en el miembro flScope de la estructura DSOP_SCOPE_INIT_INFO para el ámbito desde el que se seleccionó este objeto.

pwzClass

Puntero a una cadena Unicode terminada en null que contiene el valor del atributo objectClass del objeto.

pwzUPN

Puntero a una cadena Unicode terminada en null que contiene el valor del atributo userPrincipalName del objeto. Si el objeto no tiene un valor userPrincipalName, pwzUPN apunta a una cadena vacía (L"").

pvarFetchedAttributes

Puntero a una matriz de estructuras VARIANT . Cada VARIANT contiene el valor de un atributo del objeto seleccionado. Los atributos recuperados vienen determinados por los nombres de atributo especificados en el miembro apwzAttributeNames de la estructura DSOP_INIT_INFO que se pasa al método IDsObjectPicker::Initialize . El orden de los atributos de la matriz pvarFetchedAttributes corresponde al orden de los nombres de atributo especificados en la matriz apwzAttributeNames .

Es posible que el cuadro de diálogo del selector de objetos no pueda recuperar los atributos solicitados. Si no se puede recuperar el atributo, el miembro vt de la estructura VARIANT contiene VT_EMPTY.

flScopeType

Contiene uno o varios de los DSOP_SCOPE_TYPE_ que indican el tipo de ámbito desde el que se seleccionó este objeto. Para obtener más información y una lista de marcas de DSOP_SCOPE_TYPE_ , vea el miembro flType de la estructura DSOP_SCOPE_INIT_INFO .