DSBROWSEINFOA-Struktur (dsclient.h)
Die DSBROWSEINFO- Struktur wird mit der DsBrowseForContainer-Funktion verwendet, um Daten zum Dialogfeld Active Directory-Containerbrowser anzugeben und zurückzugeben.
Syntax
typedef struct {
DWORD cbStruct;
HWND hwndOwner;
LPCSTR pszCaption;
LPCSTR pszTitle;
LPCWSTR pszRoot;
LPWSTR pszPath;
ULONG cchPath;
DWORD dwFlags;
BFFCALLBACK pfnCallback;
LPARAM lParam;
DWORD dwReturnFormat;
LPCWSTR pUserName;
LPCWSTR pPassword;
LPWSTR pszObjectClass;
ULONG cchObjectClass;
} DSBROWSEINFOA, *PDSBROWSEINFOA;
Angehörige
cbStruct
Enthält die Größe der DSBROWSEINFO- Struktur in Byte. Dies wird von der funktion DsBrowseForContainer für Versionsverwaltungszwecke verwendet.
hwndOwner
Handle des Fensters, das als übergeordnetes Element des Containerbrowserdialogfelds verwendet wird.
pszCaption
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die die Beschriftung des Dialogfelds enthält. Wenn dieses Element NULL-ist, wird eine Standardbeschriftung verwendet.
pszTitle
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die zusätzlichen Text enthält, der im Dialogfeld oberhalb des Struktursteuerelements angezeigt werden soll. Wenn dieses Element NULL-ist, wird kein zusätzlicher Text angezeigt.
pszRoot
Zeigen Sie auf eine mit Null beendete Unicode-Zeichenfolge, die den ADsPath des Containers enthält, der im Stammverzeichnis des Dialogfelds platziert ist. Der Benutzer kann nicht über dieser Ebene mithilfe des Dialogfelds navigieren.
pszPath
Zeigen Sie auf eine mit Null beendete Unicode-Zeichenfolge, die den ADsPath des im Dialogfeld ausgewählten Containers empfängt. Diese Zeichenfolge wird immer null beendet, auch wenn cchPath- nicht groß genug ist, um den gesamten Pfad zu speichern. Wenn dwFlags das DSBI_EXPANDONOPEN Flag enthält, enthält dieses Element den ADsPath des Containers, der zunächst im Dialogfeld ausgewählt werden soll.
cchPath
Enthält die Größe des pszPath- Puffers in WCHAR- Zeichen.
dwFlags
Enthält eine Reihe von Flags, die das Verhalten des Dialogfelds definieren. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.
DSBI_NOBUTTONS (1 (0x1))
Die Schaltflächen + und - werden im Dialogfeld nicht angezeigt.
DSBI_NOLINES (2 (0x2))
Die Linien, die die Objekte im Dialogfeld verbinden, werden nicht angezeigt.
DSBI_NOLINESATROOT (4 (0x4))
Die Linien und Schaltflächen über den Stammobjekten werden nicht angezeigt.
DSBI_CHECKBOXES (256 (0x100))
Bewirkt, dass neben jedem Element in der Struktur ein Kontrollkästchen platziert wird. Der Benutzer kann die Maus verwenden, um dieses Kontrollkästchen zu aktivieren und zu deaktivieren. Dies hat derzeit eine eingeschränkte Nutzung, da es keine Möglichkeit gibt, den Überprüfungsstatus eines Elements festzulegen oder abzurufen.
DSBI_NOROOT (65536 (0x10000))
Das durch pszRootangegebene Stammobjekt wird nicht angezeigt, und die unmittelbaren untergeordneten Objekte des Stamms werden am Stamm der Struktur angezeigt. Dieses Kennzeichen hat keine Auswirkung, wenn pszRoot-NULL- ist oder wenn dieses Element DSBI_ENTIREDIRECTORYenthält.
DSBI_INCLUDEHIDDEN (131072 (0x20000))
Schließen Sie ausgeblendete Objekte in das Dialogfeld ein.
DSBI_EXPANDONOPEN (262144 (0x40000))
Wenn das Dialogfeld geöffnet wird, wird der in pszPath- angegebene Container angezeigt und ausgewählt.
DSBI_ENTIREDIRECTORY (589824 (0x90000))
Enthält alle vertrauenswürdigen Domänen an den Server, der in pszRoot- angegeben ist, oder standardmäßig die Domäne, bei der der Benutzer angemeldet ist.
DSBI_RETURN_FORMAT (1048576 (0x100000))
Gibt an, dass der dwReturnFormat Member gültig ist. Wenn dieses Flag nicht festgelegt ist, wird das Pfadformat standardmäßig auf X.500 festgelegt.
DSBI_HASCREDENTIALS (2097152 (0x200000))
pUserName- und pPassword- werden für die Zugriffsanmeldeinformationen verwendet. Andernfalls verwendet das Dialogfeld den Sicherheitskontext des aufrufenden Threads, wenn dieses Element nicht DSBI_SIMPLEAUTHENTICATEenthält.
DSBI_IGNORETREATASLEAF (4194304 (0x400000))
Bei der Ermittlung, ob das Objekt im Dialogfeld angezeigt wird, wird der treatAsLeaf Anzeigebezeichner ignoriert.
DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))
Gibt an, dass beim Aufrufen ADsOpenObject-keine sichere Authentifizierung erforderlich ist.
DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))
Gibt an, dass die pszObjectClass und cchObjectClass gültig sind und ausgefüllt werden sollen.
DSBI_DONTSIGNSEAL (33554432 (0x2000000))
Gibt an, dass das Signieren und Versiegeln bei der Kommunikation mit dem Verzeichnisdienst nicht verwendet wird.
pfnCallback
Zeiger auf eine anwendungsdefinierte BFFCallBack- Rückruffunktion, die Benachrichtigungen aus dem Containerbrowserdialogfeld empfängt. Legen Sie dieses Element auf NULL- fest, wenn es nicht verwendet wird.
lParam
Enthält einen anwendungsdefinierten 32-Bit-Wert, der als lpData- Parameter in allen Aufrufen von pfnCallback-übergeben wird. Dieses Element wird ignoriert, wenn pfnCallback-NULL-ist.
dwReturnFormat
Enthält einen der ADS_FORMAT_ENUM Werte, die das Format angibt, das der IN pszPath zurückgegebene ADSI-Pfad akzeptiert.
pUserName
Zeigen Sie auf eine Unicode-Zeichenfolge, die den Benutzernamen enthält, der für die Anmeldeinformationen verwendet wird. Dieses Element wird ignoriert, wenn dwFlags- das DSBI_HASCREDENTIALS Flag nicht festgelegt hat. Wenn dieses Element NULL-ist, wird der aktuell angemeldete Benutzername verwendet.
pPassword
Zeigen Sie auf eine Unicode-Zeichenfolge, die das für die Anmeldeinformationen verwendete Kennwort enthält. Dieses Element wird ignoriert, wenn dwFlags- das DSBI_HASCREDENTIALS Flag nicht festgelegt hat. Wenn dieses Mitglied NULL-ist, wird das Kennwort des aktuell angemeldeten Benutzers verwendet.
pszObjectClass
Zeigen Sie auf einen Unicode-Zeichenfolgenpuffer, der die Klassenzeichenfolge der ausgewählten Klasse empfängt. Dieses Element wird ignoriert, wenn dwFlags- das DSBI_RETURNOBJECTCLASS Flag nicht festgelegt hat.
cchObjectClass
Enthält die Größe des pszObjectClass- Puffers in WCHAR- Zeichen.
Bemerkungen
Anmerkung
Der dsclient.h-Header definiert DSBROWSEINFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Header- | dsclient.h |