Structure DSBROWSEINFOW (dsclient.h)
La structure DSBROWSEINFO est utilisée avec la fonction DsBrowseForContainer pour fournir et retourner des données sur la boîte de dialogue navigateur de conteneur Active Directory.
Syntaxe
typedef struct {
DWORD cbStruct;
HWND hwndOwner;
LPCWSTR pszCaption;
LPCWSTR pszTitle;
LPCWSTR pszRoot;
LPWSTR pszPath;
ULONG cchPath;
DWORD dwFlags;
BFFCALLBACK pfnCallback;
LPARAM lParam;
DWORD dwReturnFormat;
LPCWSTR pUserName;
LPCWSTR pPassword;
LPWSTR pszObjectClass;
ULONG cchObjectClass;
} DSBROWSEINFOW, *PDSBROWSEINFOW;
Membres
cbStruct
Contient la taille, en octets, de la structure DSBROWSEINFO. Cette fonction est utilisée par la fonction DsBrowseForContainer à des fins de contrôle de version.
hwndOwner
Handle de la fenêtre utilisée comme parent de la boîte de dialogue du navigateur de conteneurs.
pszCaption
Pointeur vers une chaîne terminée par null qui contient la légende de la boîte de dialogue. Si ce membre est NULL, une légende par défaut est utilisée.
pszTitle
Pointeur vers une chaîne terminée par null qui contient du texte supplémentaire à afficher dans la boîte de dialogue au-dessus du contrôle d’arborescence. Si ce membre est null, aucun texte supplémentaire n’est affiché.
pszRoot
Pointeur vers une chaîne Unicode terminée par null qui contient l’ADsPath du conteneur placé à la racine de la boîte de dialogue. L’utilisateur ne peut pas naviguer au-dessus de ce niveau à l’aide de la boîte de dialogue.
pszPath
Pointeur vers une chaîne Unicode terminée par null qui reçoit l’ADsPath du conteneur sélectionné dans la boîte de dialogue. Cette chaîne est toujours terminée par null même si cchPath n’est pas suffisamment volumineux pour contenir l’intégralité du chemin. Si dwFlags contient l’indicateur DSBI_EXPANDONOPEN, ce membre contient l’ADsPath du conteneur qui doit être initialement sélectionné dans la boîte de dialogue.
cchPath
Contient la taille, en
dwFlags
Contient un ensemble d’indicateurs qui définissent le comportement de la boîte de dialogue. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.
DSBI_NOBUTTONS (1 (0x1))
Les boutons + et - ne sont pas affichés dans la boîte de dialogue.
DSBI_NOLINES (2 (0x2))
Les lignes qui connectent les objets dans la boîte de dialogue ne sont pas affichées.
DSBI_NOLINESATROOT (4 (0x4))
Les lignes et boutons au-dessus des objets racines ne sont pas affichés.
DSBI_CHECKBOXES (256 (0x100))
Provoque l’ajout d’une case à cocher en regard de chaque élément de l’arborescence. L’utilisateur peut utiliser la souris pour activer et décocher cette case. Cela a actuellement une utilisation limitée, car il n’existe aucun moyen de définir ou d’obtenir l’état de vérification d’un élément.
DSBI_NOROOT (65536 (0x10000))
L’objet racine, spécifié par pszRoot, n’est pas affiché et les objets enfants immédiats de la racine sont affichés à la racine de l’arborescence. Cet indicateur n’a aucun effet si pszRoot est NULL ou si ce membre contient DSBI_ENTIREDIRECTORY.
DSBI_INCLUDEHIDDEN (131072 (0x20000))
Inclure des objets masqués dans la boîte de dialogue.
DSBI_EXPANDONOPEN (262144 (0x40000))
Lorsque la boîte de dialogue s’ouvre, le conteneur spécifié dans pszPath sera visible et sélectionné.
DSBI_ENTIREDIRECTORY (589824 (0x90000))
Inclut tous les domaines approuvés au serveur spécifié dans pszRoot ou, par défaut, le domaine auquel l’utilisateur est connecté.
DSBI_RETURN_FORMAT (1048576 (0x100000))
Indique que le membre dwReturnFormat est valide. Si cet indicateur n’est pas défini, le format de chemin d’accès est défini par défaut sur X.500.
DSBI_HASCREDENTIALS (2097152 (0x200000))
pUserName et pPassword sont utilisés pour les informations d’identification d’accès. Sinon, si ce membre ne contient pas DSBI_SIMPLEAUTHENTICATE, la boîte de dialogue utilise le contexte de sécurité du thread appelant.
DSBI_IGNORETREATASLEAF (4194304 (0x400000))
Lorsque vous déterminez si l’objet est affiché dans la boîte de dialogue, le treatAsLeaf spécificateur d’affichage est ignoré.
DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))
Indique que l’authentification sécurisée n’est pas nécessaire lors de l’appel ADsOpenObject.
DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))
Indique que les pszObjectClass
DSBI_DONTSIGNSEAL (33554432 (0x2000000))
Indique que la signature et le scellement ne seront pas utilisés lors de la communication avec le service d’annuaire.
pfnCallback
Pointeur vers un BFFCallBack défini par l’application fonction de rappel qui reçoit des notifications de la boîte de dialogue du navigateur de conteneurs. Définissez ce membre sur NULL s’il n’est pas utilisé.
lParam
Contient une valeur 32 bits définie par l’application passée en tant que paramètre lpData dans tous les appels à pfnCallback. Ce membre est ignoré si pfnCallback est NULL .
dwReturnFormat
Contient l’une des valeurs ADS_FORMAT_ENUM qui spécifie le format que le chemin ADSI retourné dans pszPath acceptera.
pUserName
Pointeur vers une chaîne Unicode qui contient le nom d’utilisateur utilisé pour les informations d’identification. Ce membre est ignoré si dwFlags n’a pas l’indicateur DSBI_HASCREDENTIALS défini. Si ce membre est NULL, le nom d’utilisateur actuellement connecté est utilisé.
pPassword
Pointeur vers une chaîne Unicode qui contient le mot de passe utilisé pour les informations d’identification. Ce membre est ignoré si dwFlags n’a pas l’indicateur DSBI_HASCREDENTIALS défini. Si ce membre est NULL, le mot de passe de l’utilisateur actuellement connecté est utilisé.
pszObjectClass
Pointeur vers une mémoire tampon de chaîne Unicode qui reçoit la chaîne de classe de l’élément sélectionné. Ce membre est ignoré si dwFlags n’a pas l’indicateur de DSBI_RETURNOBJECTCLASS défini.
cchObjectClass
Contient la taille, en
Remarques
Note
L’en-tête dsclient.h définit DSBROWSEINFO 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 |
| d’en-tête | dsclient.h |