DS_SELECTION struttura (objsel.h)

Articolo
08/25/2023

La struttura DS_SELECTION contiene dati relativi a un oggetto selezionato dall'utente da una finestra di dialogo selezione oggetti. La struttura DS_SELECTION_LIST contiene una matrice di strutture DS_SELECTION .

Sintassi

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

Members

pwzName

Puntatore a una stringa Unicode con terminazione null contenente il nome distinto relativo dell'oggetto (RDN).

pwzADsPath

Puntatore a una stringa Unicode con terminazione null che contiene l'ADsPath dell'oggetto. Il formato di questa stringa dipende dai flag specificati nel membro flScope della struttura DSOP_SCOPE_INIT_INFO per l'ambito da cui è stato selezionato questo oggetto.

pwzClass

Puntatore a una stringa Unicode con terminazione null contenente il valore dell'attributo objectClass dell'oggetto.

pwzUPN

Puntatore a una stringa Unicode con terminazione null contenente il valore dell'attributo userPrincipalName dell'oggetto. Se l'oggetto non ha un valore userPrincipalName, pwzUPN punta a una stringa vuota (L"").

pvarFetchedAttributes

Puntatore a una matrice di strutture VARIANT . Ogni VARIANT contiene il valore di un attributo dell'oggetto selezionato. Gli attributi recuperati sono determinati dai nomi degli attributi specificati nel membro apwzAttributeNames della struttura DSOP_INIT_INFO passata al metodo IDsObjectPicker::Initialize . L'ordine degli attributi nella matrice pvarFetchedAttributes corrisponde all'ordine dei nomi di attributi specificati nella matrice apwzAttributeNames .

La finestra di dialogo selezione oggetti potrebbe non essere in grado di recuperare gli attributi richiesti. Se l'attributo non può essere recuperato, il membro vt della struttura VARIANT contiene VT_EMPTY.

flScopeType

Contiene uno o più DSOP_SCOPE_TYPE_ che indicano il tipo di ambito da cui è stato selezionato questo oggetto. Per altre informazioni e un elenco di flag DSOP_SCOPE_TYPE_, vedere il membro flTypedella struttura DSOP_SCOPE_INIT_INFO.