Structure DSBITEMW (dsclient.h)

La structure DSBITEM contient des données sur un élément dans la boîte de dialogue du navigateur de conteneur Active Directory. Cette structure est transmise avec la notification DSBM_QUERYINSERT à la fonction de rappel BFFCallBack . La boîte de dialogue du navigateur de conteneur est créée avec la fonction DsBrowseForContainer .

Syntaxe

typedef struct {
  DWORD   cbStruct;
  LPCWSTR pszADsPath;
  LPCWSTR pszClass;
  DWORD   dwMask;
  DWORD   dwState;
  DWORD   dwStateMask;
  WCHAR   szDisplayName[DSB_MAX_DISPLAYNAME_CHARS];
  WCHAR   szIconLocation[MAX_PATH];
  INT     iIconResID;
} DSBITEMW, *PDSBITEMW;

Membres

cbStruct

Contient la taille, en octets, de la structure.

pszADsPath

Pointeur vers une chaîne Unicode terminée par null qui contient l’ADsPath de l’élément.

pszClass

Pointeur vers une chaîne Unicode terminée par null qui contient le nom de classe d’objet de l’élément.

dwMask

Contient un ensemble d’indicateurs qui indiquent quels membres de la structure contiennent des données valides. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

DSBF_DISPLAYNAME

Le membre szDisplayName contient des données valides.

DSBF_ICONLOCATION

Les membres szIconLocation et iIconResID contiennent des données valides.

DSBF_STATE

Les membres dwState et dwStateMask contiennent des données valides.

dwState

Contient un ensemble d’indicateurs qui indiquent l’état de l’élément. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

DSBS_CHECKED

Si cet indicateur est défini, l’élément est sélectionné. Sinon, l’élément n’est pas sélectionné. Cet indicateur n’est actuellement pas pris en charge.

DSBS_HIDDEN

Si cet indicateur est défini, l’élément est masqué. Sinon, l’élément est visible.

DSBS_ROOT

Si cet indicateur est défini, l’élément est un élément racine. Sinon, l’élément n’est pas un élément racine.

dwStateMask

Contient un ensemble d’indicateurs qui indiquent quels indicateurs dans le membre dwState contiennent des données valides. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes. Par exemple, si dwStateMask a l’indicateur DSBS_HIDDEN défini et que dwStaten’a pas l’indicateur DSBS_HIDDEN défini, l’élément est visible. Si dwStateMask n’a pas l’indicateur DSBS_HIDDEN défini, l’indicateur DSBS_HIDDEN dans dwState doit être ignoré.

DSBS_CHECKED

L’indicateur DSBS_CHECKED dans le membre dwState contient des données valides.

DSBS_HIDDEN

L’indicateur DSBS_HIDDEN dans le membre dwState contient des données valides.

DSBS_ROOT

L’indicateur DSBS_ROOT dans le membre dwState contient des données valides.

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

Pointeur vers une chaîne terminée par null qui contient le nom d’affichage de l’élément. Le nom d’affichage d’un élément peut être modifié en copiant le nouveau nom d’affichage dans ce membre, en définissant l’indicateur DSBF_DISPLAYNAME dans le membre dwMask et en retournant une valeur différente de zéro à partir de BFFCallBack.

szIconLocation[MAX_PATH]

Pointeur vers une chaîne terminée par null qui contient le nom d’un fichier .exe, .dll ou .ico contenant l’icône à afficher pour l’élément. Il peut s’agir de n’importe quel type de fichier qui peut être passé à la fonction ExtractIcon . L’index de cette icône est spécifié dans iIconResID. Pour modifier l’icône affichée pour l’élément, copiez le nom du fichier source de l’icône dans ce membre, définissez iIconResID sur l’index de base zéro de l’icône, définissez l’indicateur DSBF_ICONLOCATION dans le membre dwMask et retournez une valeur différente de zéro à partir de BFFCallBack.

iIconResID

Contient l’index de base zéro de l’icône à afficher pour l’élément.

Note Il ne s’agit pas de l’identificateur de ressource de l’icône.

 

Notes

Notes

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

BFFCallBack

DsBrowseForContainer

ExtractIcon