DsBrowseForContainerW, fonction (dsclient.h)

La fonction DsBrowseForContainer affiche une boîte de dialogue permettant de rechercher des objets conteneur dans services de domaine Active Directory.

Syntaxe

int DsBrowseForContainerW(
  [in] PDSBROWSEINFOW pInfo
);

Paramètres

[in] pInfo

Pointeur vers une structure DSBROWSEINFO qui contient des données sur l’initialisation de la boîte de dialogue du navigateur de conteneur et reçoit des données sur l’objet sélectionné.

Valeur retournée

La fonction retourne l’une des valeurs suivantes.

Notes

La boîte de dialogue affiche un sélecteur de conteneurs qui est rempli avec des conteneurs d’une racine particulière ou qui utilise des domaines approuvés. S’il utilise des domaines approuvés, il peut utiliser le domaine auquel l’utilisateur est actuellement connecté, ou il peut utiliser un autre domaine spécifié par l’application à l’aide du membre pszRoot de la structure DSBROWSEINFO . Si l’utilisateur clique sur le bouton pushbutton OK ou double-clique sur un objet, IDOK est retourné et pszPath contient l’ADsPath de l’objet sélectionné. Si l’utilisateur annule la boîte de dialogue, DsBrowseForContainer retourne IDCANCEL.

Le membre pszRoot contient un ADsPath, qui nécessite le formulaire suivant.

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

DsBrowseForContainer utilise ce chemin comme racine de l’arborescence. Le membre pszRoot peut également être utilisé pour spécifier un domaine qui a une approbation avec le domaine auquel l’utilisateur est connecté, afin que l’utilisateur puisse parcourir le conteneur Utilisateurs du domaine secondaire. Si le membre pszPath contient un chemin, la boîte de dialogue navigue à partir de pszRoot à travers les conteneurs jusqu’à ce qu’elle atteigne l’objet spécifié par pszPath.

La fonction DsBrowseForContainer prend en charge une fonction de rappel comme spécifié dans la structure DSBROWSEINFO . La fonction de rappel peut être utilisée pour filtrer, modifier ou mettre à jour la vue en fonction de la modification de la sélection, etc. Pour plus d’informations, consultez BFFCallBack.

Important À compter de Windows Server 2003, la version ANSI de cette fonction (DsBrowseForContainerA) n’est pas implémentée et retourne toujours -1.

 

Exemples

L’exemple de code suivant choisit un conteneur dans le domaine auquel l’utilisateur est connecté. La vue affiche également tous les domaines approuvés.

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
    }
}

Notes

L’en-tête dsclient.h définit DsBrowseForContainer en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	dsclient.h
Bibliothèque	Dsuiext.lib
DLL	Dsuiext.dll

Voir aussi

BFFCallBack

DSBROWSEINFO