DsBrowseForContainerW-Funktion (dsclient.h)

Die DsBrowseForContainer--Funktion zeigt ein Dialogfeld an, das zum Suchen nach Containerobjekten in Active Directory Domain Services verwendet wird.

Syntax

int DsBrowseForContainerW(
  [in] PDSBROWSEINFOW pInfo
);

Parameter

[in] pInfo

Zeiger auf eine DSBROWSEINFO Struktur, die Daten zum Initialisieren des Containerbrowserdialogfelds enthält und Daten über das ausgewählte Objekt empfängt.

Rückgabewert

Die Funktion gibt IDOK zurück, wenn der Benutzer einen Container auswählt und auf die Schaltfläche "OK " klickt oder auf ein Objekt doppelklimmt. Wenn der Benutzer das Dialogfeld abbricht, gibt die Funktion IDCANCEL zurück. Wenn ein Fehler auftritt, gibt die Funktion zurück -1. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

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, an der der Benutzer derzeit angemeldet ist, oder eine alternative Domäne verwenden, die von der Anwendung mithilfe des pszRoot Mitglieds der DSBROWSEINFO- Struktur angegeben wird. Wenn der Benutzer auf die Schaltfläche "OK " klickt oder auf ein Objekt doppelklimmt, wird IDOK zurückgegeben, und pszPath enthält den ADsPath des ausgewählten Objekts. Wenn der Benutzer das Dialogfeld abbricht, gibt DsBrowseForContainerIDCANCELzurück.

Das pszRoot-Element enthält einen ADsPath, der im folgenden Format vorliegen muss:

LDAP://fabrikam.com/CN=Users,DC=Fabrikam,DC=com

DsBrowseForContainer- verwendet diesen Pfad als Stamm der Struktur. Das pszRoot-Mitglied 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, damit der Benutzer den Container "Benutzer" der alternativen Domäne durchsuchen kann. Wenn das pszPath Member einen Pfad enthält, navigiert das Dialogfeld von pszRoot durch die Container, bis es das durch pszPathangegebene Objekt erreicht.

Die DsBrowseForContainer--Funktion unterstützt eine Rückruffunktion, wie in der DSBROWSEINFO- Struktur angegeben. Die Rückruffunktion kann verwendet werden, um die Ansicht basierend auf Auswahländerungen 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
    }
}

Anforderungen

Siehe auch

BFFCallBack-

DSBROWSEINFO