Structure DSBITEMA (dsclient.h)
La structure DSBITEM
Syntaxe
typedef struct {
DWORD cbStruct;
LPCWSTR pszADsPath;
LPCWSTR pszClass;
DWORD dwMask;
DWORD dwState;
DWORD dwStateMask;
CHAR szDisplayName[DSB_MAX_DISPLAYNAME_CHARS];
CHAR szIconLocation[MAX_PATH];
INT iIconResID;
} DSBITEMA, *PDSBITEMA;
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 la classe d’objet de l’élément.
dwMask
Contient un ensemble d’indicateurs qui indiquent les membres de la structure qui 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 iIconRes ID contiennent des données valides.
DSBF_STATE
Les membres dwState et dwStateMa sk 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 le jeu d’indicateurs DSBS_HIDDEN et dwState n’a pas le jeu d’indicateurs de DSBS_HIDDEN, l’élément est visible. Si dwStateMask n’a pas l’indicateur de 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
szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]
Pointeur vers une chaîne terminée par null qui contient le nom complet 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 de BFFCallBack.
szIconLocation[MAX_PATH]
Pointeur vers une chaîne terminée par null qui contient le nom d’un .exe, .dllou fichier .ico qui contient 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 d’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 renvoyez une valeur différente de zéro de BFFCallBack.
iIconResID
Contient l’index de base zéro de l’icône à afficher pour l’élément.
Remarques
Note
L’en-tête dsclient.h définit DSBITEM 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. 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 |