DsBrowseForContainerA-Funktion (dsclient.h)
Die DsBrowseForContainer-Funktion zeigt ein Dialogfeld an, das zum Suchen nach Containerobjekten in Active Directory Domain Services verwendet wird.
Syntax
int DsBrowseForContainerA(
[in] PDSBROWSEINFOA pInfo
);
Parameter
[in] pInfo
Zeiger auf eine DSBROWSEINFO-Struktur , die Daten zum Initialisieren des Containerbrowserdialogfelds enthält und Daten zum ausgewählten Objekt empfängt.
Rückgabewert
Die Funktion gibt einen der folgenden Werte zurück.
Hinweise
Im Dialogfeld wird eine Containerauswahl angezeigt, die entweder mit Containern aus einem bestimmten Stamm aufgefüllt wird oder vertrauenswürdige Domänen verwendet. Wenn sie vertrauenswürdige Domänen verwendet, kann sie entweder die Domäne verwenden, bei der der Benutzer derzeit angemeldet ist, oder eine alternative Domäne verwenden, die von der Anwendung mithilfe des pszRoot-Members der DSBROWSEINFO-Struktur angegeben wird. Wenn der Benutzer auf die Schaltfläche OK klickt oder auf ein Objekt doppelt klickt, wird IDOK zurückgegeben, und pszPath enthält den ADsPath des ausgewählten Objekts. Wenn der Benutzer das Dialogfeld abbricht, gibt DsBrowseForContainerIDCANCEL zurück.
Das pszRoot-Element enthält einen ADsPath, für den das folgende Formular erforderlich ist.
LDAP://fabrikam.com/CN=Users,DC=Fabrikam,DC=com
DsBrowseForContainer verwendet diesen Pfad als Stamm der Struktur. Das pszRoot-Member kann auch verwendet werden, um eine Domäne anzugeben, die über eine Vertrauensstellung mit der Domäne verfügt, bei der der Benutzer angemeldet ist, sodass der Benutzer den Container Benutzer der alternativen Domäne durchsuchen kann. Wenn das pszPath-Element einen Pfad enthält, navigiert das Dialogfeld von pszRoot durch die Container, bis es das von pszPath angegebene Objekt erreicht.
Die DsBrowseForContainer-Funktion unterstützt eine Rückruffunktion, die in der DSBROWSEINFO-Struktur angegeben ist. Die Rückruffunktion kann verwendet werden, um die Ansicht basierend auf der Auswahländerung zu filtern, zu ändern oder anderweitig zu aktualisieren usw. Weitere Informationen finden Sie unter BFFCallBack.
Beispiele
Im folgenden Codebeispiel wird ein Container in der Domäne ausgewählt, bei der der Benutzer angemeldet ist. In der Ansicht werden auch alle vertrauenswürdigen Domänen angezeigt.
void PickContainer(void)
{
DSBROWSEINFOW dsbi = { 0 };
WCHAR wszResult[MAX_PATH];
dsbi.cbStruct = sizeof(dsbi);
dsbi.pszCaption = L"The container picker";
dsbi.pszTitle = L"Pick a container for this example.";
dsbi.pszPath = wszResult;
dsbi.cchPath = MAX_PATH;
dsbi.dwFlags = DSBI_ENTIREDIRECTORY;
int nReturn = DsBrowseForContainerW(&dsbi);
if ( IDOK == nReturn )
{
// wszResult contains the resulting path
}
}
Hinweis
Der dsclient.h-Header definiert DsBrowseForContainer 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 nicht codierungsneutralem Code 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 |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista |
Unterstützte Mindestversion (Server) | Windows Server 2008 |
Zielplattform | Windows |
Kopfzeile | dsclient.h |
Bibliothek | Dsuiext.lib |
DLL | Dsuiext.dll |