DSOP_INIT_INFO-Struktur (objsel.h)

Artikel
08/25/2023

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.