DsBrowseForContainerW, fonction (dsclient.h)
La fonction DsBrowseForContainer affiche une boîte de dialogue utilisée pour rechercher des objets conteneur dans Active Directory Domain Services.
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 conteneurs et reçoit des données sur l’objet sélectionné.
Valeur de retour
La fonction retourne l’une des valeurs suivantes.
Remarques
La boîte de dialogue affiche un sélecteur de conteneurs rempli avec des conteneurs à partir 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 de l'pszRoot membre de la structure DSBROWSEINFO. Si l’utilisateur clique sur le OK bouton push 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 d’accès, la boîte de dialogue navigue de pszRoot via les conteneurs jusqu’à ce qu’elle atteigne l’objet spécifié par pszPath.
La fonction DsBrowseForContainer prend en charge une fonction de rappel spécifiée dans la structure DSBROWSEINFO. La fonction de rappel peut être utilisée pour filtrer, modifier ou mettre à jour l’affichage en fonction du changement de sélection, et ainsi de suite. Pour plus d’informations, consultez BFFCallBack.
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
}
}
Note
L’en-tête dsclient.h définit DsBrowseForContainer comme 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| serveur minimum pris en charge | Windows Server 2008 |
| plateforme cible | Windows |
| d’en-tête | dsclient.h |
| bibliothèque | Dsuiext.lib |
| DLL | Dsuiext.dll |