Structure DSBROWSEINFOA (dsclient.h)

Article
08/23/2023

La structure DSBROWSEINFO est utilisée avec la fonction DsBrowseForContainer pour fournir et retourner des données sur la boîte de dialogue du navigateur de conteneur Active Directory.

Syntaxe

typedef struct {
  DWORD       cbStruct;
  HWND        hwndOwner;
  LPCSTR      pszCaption;
  LPCSTR      pszTitle;
  LPCWSTR     pszRoot;
  LPWSTR      pszPath;
  ULONG       cchPath;
  DWORD       dwFlags;
  BFFCALLBACK pfnCallback;
  LPARAM      lParam;
  DWORD       dwReturnFormat;
  LPCWSTR     pUserName;
  LPCWSTR     pPassword;
  LPWSTR      pszObjectClass;
  ULONG       cchObjectClass;
} DSBROWSEINFOA, *PDSBROWSEINFOA;

Membres

cbStruct

Contient la taille, en octets, de la structure DSBROWSEINFO . Il est utilisé 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 conteneur.

pszCaption

Pointeur vers une chaîne terminée par null qui contient le légende de la boîte de dialogue. Si ce membre a la valeur 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 a la valeur 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 sera toujours terminée par null même si cchPath n’est pas assez grand pour contenir l’intégralité du chemin d’accès. Si dwFlags contient l’indicateur DSBI_EXPANDONOPEN , ce membre contient l’ADsPath du conteneur qui doit être sélectionné initialement dans la boîte de dialogue.

cchPath

Contient la taille, en caractères WCHAR , de la mémoire tampon pszPath .

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 s’affichent pas dans la boîte de dialogue.

DSBI_NOLINES (2 (0x2))

Les lignes qui relient les objets de la boîte de dialogue ne s’affichent pas.

DSBI_NOLINESATROOT (4 (0x4))

Les lignes et les boutons au-dessus des objets racine ne s’affichent pas.

DSBI_CHECKBOXES (256 (0x100))

Entraîne la place d’une zone case activée en regard de chaque élément de l’arborescence. L’utilisateur peut utiliser la souris pour sélectionner et effacer cette zone case activée. Son utilisation est actuellement limitée, car il n’existe aucun moyen de définir ou d’obtenir l’état case activée 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 a la valeur NULL ou si ce membre contient DSBI_ENTIREDIRECTORY.

DSBI_INCLUDEHIDDEN (131072 (0x20000))

Incluez 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 est visible et sélectionné.

DSBI_ENTIREDIRECTORY (589824 (0x90000))

Inclut tous les domaines approuvés sur le 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 s’affiche dans la boîte de dialogue, le spécificateur d’affichage treatAsLeaf est ignoré.

DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))

Indique que l’authentification sécurisée n’est pas requise lors de l’appel d’ADsOpenObject.

DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))

Indique que pszObjectClass et cchObjectClass sont valides et doivent être renseignés.

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 une fonction de rappel BFFCallBack définie par l’application qui reçoit des notifications à partir de la boîte de dialogue du navigateur de conteneur. 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 a la valeur 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 a la valeur 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 a la valeur 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 du sélectionné. Ce membre est ignoré si dwFlags n’a pas l’indicateur DSBI_RETURNOBJECTCLASS défini.

cchObjectClass

Contient la taille, en caractères WCHAR , de la mémoire tampon pszObjectClass .

Notes

L’en-tête dsclient.h définit DSBROWSEINFO comme un 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.

Spécifications


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	dsclient.h

Voir aussi