DSOP_INIT_INFO-Struktur (objsel.h)
Die DSOP_INIT_INFO-Struktur enthält Daten, die zum Initialisieren eines Dialogfelds für die Objektauswahl erforderlich sind. Diese Struktur wird mit der IDsObjectPicker::Initialize-Methode verwendet.
Syntax
typedef struct _DSOP_INIT_INFO {
ULONG cbSize;
PCWSTR pwzTargetComputer;
ULONG cDsScopeInfos;
PDSOP_SCOPE_INIT_INFO aDsScopeInfos;
ULONG flOptions;
ULONG cAttributesToFetch;
PCWSTR *apwzAttributeNames;
} DSOP_INIT_INFO, *PDSOP_INIT_INFO;
Member
cbSize
Enthält die Größe der Struktur in Bytes.
pwzTargetComputer
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Zielcomputers enthält. Das Dialogfeld funktioniert so, als ob es auf dem Zielcomputer ausgeführt wird, indem der Zielcomputer verwendet wird, um die eingebundene Domäne und das Unternehmen zu ermitteln. Wenn dieser Wert NULL ist, ist der Zielcomputer der lokale Computer.
cDsScopeInfos
Gibt die Anzahl der Elemente im Array aDsScopeInfos an.
aDsScopeInfos
Zeiger auf ein Array von DSOP_SCOPE_INIT_INFO Strukturen, die die Bereiche beschreiben, aus denen der Benutzer Objekte auswählen kann. Dieser Member darf nicht NULL sein, und das Array muss mindestens ein Element enthalten, da die Objektauswahl nicht ohne mindestens einen Bereich ausgeführt werden kann.
flOptions
Flags, die die Optionen für die Objektauswahl bestimmen. Dieser Member kann null oder eine Kombination aus mindestens einem der folgenden Flags sein.
DSOP_FLAG_MULTISELECT (0x00000001)
Wenn dieses Flag festgelegt ist, kann der Benutzer mehrere Objekte auswählen. Wenn dieses Flag nicht festgelegt ist, kann der Benutzer nur ein Objekt auswählen.
DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)
Wenn dieses Flag festgelegt ist und das DSOP_SCOPE_TYPE_TARGET_COMPUTER-Flag im Array aDsScopeInfos festgelegt ist, ist der Zielcomputer immer in der Dropdownliste Suchen in enthalten.
Wenn dieses Flag nicht festgelegt ist und der Zielcomputer ein Domänencontroller auf up-level oder down-level ist, wird das flag DSOP_SCOPE_TYPE_TARGET_COMPUTER ignoriert, und der Zielcomputer ist nicht in der Dropdownliste Suchen in enthalten.
Um Zeit während der Initialisierung zu sparen, sollte dieses Flag festgelegt werden, wenn bekannt ist, dass der Zielcomputer kein Domänencontroller ist. Wenn es sich bei dem Zielcomputer jedoch um einen Domänencontroller handelt, sollte dieses Flag nicht festgelegt werden, da es für den Benutzer besser ist, Domänenobjekte aus dem Domänenbereich und nicht aus dem Domänencontroller selbst auszuwählen.
cAttributesToFetch
Enthält die Anzahl der Elemente im Array apwzAttributeNames . Dieser Member kann 0 sein.
apwzAttributeNames
Zeiger auf ein Array von Unicode-Zeichenfolgen mit NULL-Beendigung, die die Namen der Attribute enthalten, die für jedes ausgewählte Objekt abgerufen werden sollen. Wenn cAttributesToFetch null ist, wird dieses Element ignoriert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Kopfzeile | objsel.h |