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 über das ausgewählte Objekt empfängt.

Rückgabewert

Die Funktion gibt einen der folgenden Werte zurück.

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 das OK-Pushbutton 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 Member enthält einen ADsPath, der das folgende Formular erfordert.

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, sodass der Benutzer den Benutzer Container 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