DSOP_SCOPE_INIT_INFO-Struktur (objsel.h)
Die DSOP_SCOPE_INIT_INFO-Struktur beschreibt mindestens einen Bereichstyp mit den gleichen Attributen. Ein Bereichstyp ist ein Standorttyp, z. B. eine Domäne, ein Computer oder ein globaler Katalog, aus dem der Benutzer Objekte auswählen kann. Diese Struktur wird mit DSOP_INIT_INFO verwendet, wenn IDsObjectPicker::Initialize aufgerufen wird.
Syntax
typedef struct _DSOP_SCOPE_INIT_INFO {
ULONG cbSize;
ULONG flType;
ULONG flScope;
DSOP_FILTER_FLAGS FilterFlags;
PCWSTR pwzDcName;
PCWSTR pwzADsPath;
HRESULT hr;
} DSOP_SCOPE_INIT_INFO, *PDSOP_SCOPE_INIT_INFO;
Member
cbSize
Enthält die Größe der Struktur in Bytes.
flType
Flags, die die von dieser Struktur beschriebenen Bereichstypen angeben. Sie können mehrere Bereichstypen kombinieren, wenn alle angegebenen Bereiche dieselben Einstellungen verwenden. Dieser Member kann eine Kombination der folgenden Flags sein.
DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x00000001)
Computer, der vom pwzTargetComputer-Member der DSOP_INIT_INFO-Struktur angegeben wird.
Wenn es sich bei dem Zielcomputer um einen Domänencontroller auf höherer oder untergeordneter Ebene handelt, wird dieses Flag ignoriert, es sei denn, das DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK-Flag ist im flOptions-Member der DSOP_INIT_INFO-Struktur festgelegt.
DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN (0x00000002)
Eine Domäne der obersten Ebene, in die der Zielcomputer eingebunden ist. Wenn dieses Flag festgelegt ist, verwenden Sie das pwzDcName-Element , um den Namen eines Domänencontrollers in der eingebundenen Domäne anzugeben.
DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x00000004)
Eine Domäne auf untergeordneter Ebene, in die der Zielcomputer eingebunden ist.
DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)
Alle Domänen im Unternehmen, zu dem der Zielcomputer gehört. Wenn der DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN Bereich angegeben ist, stellt der DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN Bereich alle Domänen im Unternehmen mit Ausnahme der eingebundenen Domäne dar.
DSOP_SCOPE_TYPE_GLOBAL_CATALOG (0x00000010)
Ein Bereich, der Objekte aus allen Domänen im Unternehmen enthält. Ein Unternehmen darf nur Domänen der obersten Ebene enthalten.
DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x00000020)
Alle Domänen der obersten Ebene außerhalb des Unternehmens, aber von der Domäne vertrauenswürdig, der der Zielcomputer zugeordnet ist.
DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN (0x00000040)
Alle untergeordneten Domänen außerhalb des Unternehmens, aber von der Domäne vertrauenswürdig, in die der Zielcomputer eingebunden ist.
DSOP_SCOPE_TYPE_WORKGROUP (0x00000080)
Die Arbeitsgruppe, in die der Zielcomputer eingebunden ist. Gilt nur, wenn der Zielcomputer nicht in eine Domäne eingebunden ist.
Der einzige Objekttyp, der aus einer Arbeitsgruppe ausgewählt werden kann, ist ein Computer.
DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE (0x00000100)
Ermöglicht dem Benutzer die Eingabe eines Bereichs auf up-level. Wenn keiner der DSOP_SCOPE_TYPE_USER_ENTERED_* -Typen angegeben wird, beschränkt das Dialogfeld den Benutzer auf die Bereiche in der Dropdownliste Suchen in .
DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)
Ermöglicht es dem Benutzer, einen Bereich auf untergeordneter Ebene einzugeben.
flScope
Flags, die das Format angeben, das zum Zurückgeben von ADsPath für objekte verwendet wird, die aus diesem Bereich ausgewählt wurden. Das flScope-Element kann auch den anfänglichen Bereich angeben, der in der Dropdownliste Suchen in angezeigt wird. Dieser Member kann eine Kombination der folgenden Flags sein.
LDAP- und Gc-Pfade (Global Catalog) können in die WinNT ADsPath-Syntax konvertiert werden. GC-Pfade können in das LDAP-Format konvertiert werden. WinNT-Objekte mit einem objectSid-Attribut können in das LDAP-Format konvertiert werden, wenn Sie die DSOP_SCOPE_FLAG_WANT_SID_PATH - oder DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP-Flags angeben. Andere Konvertierungen sind nicht legal.
DSOP_SCOPE_FLAG_STARTING_SCOPE (0x00000001)
Der von dieser Struktur beschriebene Bereich wird zunächst in der Dropdownliste Suchen in ausgewählt. Nur ein Bereich kann dieses Flag angeben. Wenn kein Bereich dieses Flag angibt, ist der anfängliche Bereich der erste erfolgreich erstellte Bereich in dem Array von Bereichen, die an die IDsObjectPicker::Initialize-Methode übergeben wurden.
DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)
Die ADsPaths werden in die Verwendung des WinNT-Anbieters konvertiert. Weitere Informationen finden Sie unter WinNT ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)
Die ADsPaths werden in die Verwendung des LDAP-Anbieters konvertiert. Weitere Informationen finden Sie unter LDAP ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_GC (0x00000008)
Die ADsPaths für objekte, die aus diesem Bereich ausgewählt wurden, werden in die Verwendung des GC-Anbieters konvertiert.
DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)
Die ADsPaths mit einem objectSid-Attribut werden in das Format LDAP://< SID=x> konvertiert, wobei x die hexadezimalen Ziffern des objectSid-Attributwerts darstellt.
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
Die ADsPaths für herunterstehende, bekannte SID-Objekte sind eine leere Zeichenfolge, es sei denn, dieses Flag wird angegeben (z. B.; DSOP_DOWNLEVEL_FILTER_INTERACTIVE). Wenn dieses Flag angegeben ist, haben die Pfade das Format
WinNT://NT AUTHORITY/Interactive oder WinNT://Creator Besitzer.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)
Wenn der Bereichsfilter Benutzer enthält, aktivieren Sie das Kontrollkästchen Benutzer im Dialogfeld.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)
Wenn der Bereichsfilter Gruppen enthält, aktivieren Sie das Kontrollkästchen Gruppen im Dialogfeld.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)
Wenn der Bereichsfilter Computer enthält, aktivieren Sie das Kontrollkästchen Computer im Dialogfeld.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)
Wenn der Bereichsfilter Kontakte enthält, aktivieren Sie das Kontrollkästchen Kontakte im Dialogfeld.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)
Wenn der Bereichsfilter Dienstkonten enthält, aktivieren Sie im Dialogfeld die Kontrollkästchen Dienstkonten und verwaltete Gruppendienstkonten .
DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x00000800)
Wenn der Bereichsfilter Kennworteinstellungsobjekte enthält, aktivieren Sie das Kontrollkästchen Kennworteinstellungsobjekte im Dialogfeld.
FilterFlags
Enthält eine DSOP_FILTER_FLAGS-Struktur , die die Typen von Objekten angibt, die dem Benutzer für diesen bereich oder diesen Bereich angezeigt werden.
pwzDcName
Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen eines Domänencontrollers der Domäne enthält, in die der Zielcomputer eingebunden ist. Dieses Element wird nur verwendet, wenn das flType-Element das flag DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN enthält. Wenn dieses Flag nicht festgelegt ist, muss pwzDcNameNULL sein.
Dieser Member kann NULL sein, auch wenn das DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN-Flag angegeben ist. In diesem Fall sucht das Dialogfeld den Domänencontroller. Mit diesem Member können Sie einen bestimmten Domänencontroller in einer Multimasterdomäne benennen. Beispielsweise kann eine administrative Anwendung Änderungen an einem Domänencontroller in einer Multimasterdomäne vornehmen und dann das Dialogfeld Objektauswahl öffnen, bevor die Änderungen auf den anderen Domänencontrollern repliziert wurden.
pwzADsPath
Reserviert; muss NULL sein.
hr
Enthält einen HRESULT-Wert, der die status des spezifischen Bereichs angibt. Wenn die IDsObjectPicker::Initialize-Methode den von dieser Struktur angegebenen Bereich erfolgreich erstellt, enthält hrS_OK. Andernfalls enthält hr einen Fehlercode.
Wenn IDsObjectPicker::InitializeS_OK zurückgibt, enthalten die hr-Member aller angegebenen DSOP_SCOPE_INIT_INFO-Strukturen auch S_OK.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Kopfzeile | objsel.h |