estrutura DS_SELECTION (objsel.h)

Artigo
08/25/2023

A estrutura DS_SELECTION contém dados sobre um objeto selecionado pelo usuário em uma caixa de diálogo do seletor de objetos. A estrutura DS_SELECTION_LIST contém uma matriz de estruturas DS_SELECTION .

Sintaxe

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

Membros

pwzName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o RDN (nome diferenciado relativo) do objeto.

pwzADsPath

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o ADsPath do objeto. O formato dessa cadeia de caracteres depende dos sinalizadores especificados no membro flScope da estrutura DSOP_SCOPE_INIT_INFO para o escopo do qual esse objeto foi selecionado.

pwzClass

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o valor do atributo objectClass do objeto.

pwzUPN

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o valor do atributo userPrincipalName do objeto. Se o objeto não tiver um valor userPrincipalName, pwzUPN apontará para uma cadeia de caracteres vazia (L"").

pvarFetchedAttributes

Ponteiro para uma matriz de estruturas VARIANT . Cada VARIANT contém o valor de um atributo do objeto selecionado. Os atributos recuperados são determinados pelos nomes de atributo especificados no membro apwzAttributeNames da estrutura DSOP_INIT_INFO passada para o método IDsObjectPicker::Initialize . A ordem dos atributos na matriz pvarFetchedAttributes corresponde à ordem dos nomes de atributo especificados na matriz apwzAttributeNames .

A caixa de diálogo seletor de objeto pode não ser capaz de recuperar os atributos solicitados. Se o atributo não puder ser recuperado, o membro vt da estrutura VARIANT conterá VT_EMPTY.

flScopeType

Contém um ou mais dos DSOP_SCOPE_TYPE_ que indicam o tipo de escopo do qual esse objeto foi selecionado. Para obter mais informações e uma lista de sinalizadores de DSOP_SCOPE_TYPE_ , consulte o membro flType da estrutura DSOP_SCOPE_INIT_INFO .