DS_SELECTION-Struktur (objsel.h)

Artikel
03/04/2024

Die DS_SELECTION-Struktur enthält Daten zu einem Objekt, das der Benutzer aus einem Objektauswahldialogfeld ausgewählt hat. Die DS_SELECTION_LIST-Struktur enthält ein Array von DS_SELECTION Strukturen.

Syntax

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

Member

pwzName

Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den relativen distinguished Name (RDN) des Objekts enthält.

pwzADsPath

Zeiger auf eine unicode-Zeichenfolge mit Null-Endung, die den ADsPath des Objekts enthält. Das Format dieser Zeichenfolge hängt von den Flags ab, die im flScope-Member der DSOP_SCOPE_INIT_INFO-Struktur für den Bereich angegeben sind, aus dem dieses Objekt ausgewählt wurde.

pwzClass

Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Wert des objectClass-Attributs des Objekts enthält.

pwzUPN

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den UserPrincipalName-Attributwert des Objekts enthält. Wenn das Objekt keinen userPrincipalName-Wert aufweist, verweist pwzUPN auf eine leere Zeichenfolge (L").

pvarFetchedAttributes

Zeiger auf ein Array von VARIANT-Strukturen . Jeder VARIANT-Wert enthält den Wert eines Attributs des ausgewählten Objekts. Die abgerufenen Attribute werden durch die Attributnamen bestimmt, die im apwzAttributeNames-Member der an die IDsObjectPicker::Initialize-Methode übergebenen DSOP_INIT_INFO-Struktur angegeben sind. Die Reihenfolge der Attribute im pvarFetchedAttributes-Array entspricht der Reihenfolge der Attributnamen, die im apwzAttributeNames-Array angegeben sind.

Das Dialogfeld für die Objektauswahl kann die angeforderten Attribute möglicherweise nicht abrufen. Wenn das Attribut nicht abgerufen werden kann, enthält das vt-Element der VARIANT-StrukturVT_EMPTY.

flScopeType

Enthält mindestens eine der DSOP_SCOPE_TYPE_ , die den Typ des Bereichs angeben, aus dem dieses Objekt ausgewählt wurde. Weitere Informationen und eine Liste mit DSOP_SCOPE_TYPE_ Flags finden Sie im flType-Element der DSOP_SCOPE_INIT_INFO-Struktur .