Estructura DSBITEMA (dsclient.h)

La estructura DSBITEM contiene datos sobre un elemento en el cuadro de diálogo explorador de contenedores de Active Directory. Esta estructura se pasa con la notificación DSBM_QUERYINSERT a la función de devolución de llamada BFFCallBack. El cuadro de diálogo del explorador de contenedores se crea con la función DsBrowseForContainer.

Sintaxis

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;

Miembros

cbStruct

Contiene el tamaño, en bytes, de la estructura.

pszADsPath

Puntero a una cadena Unicode terminada en null que contiene ADsPath del elemento.

pszClass

Puntero a una cadena Unicode terminada en null que contiene el nombre de clase de objeto del elemento.

dwMask

Contiene un conjunto de marcas que indican qué miembros de la estructura contienen datos válidos. Puede ser cero o una combinación de uno o varios de los valores siguientes.

DSBF_DISPLAYNAME

El miembro szDisplayName contiene datos válidos.

DSBF_ICONLOCATION

Los szIconLocation y miembros de iIconResID contienen datos válidos.

DSBF_STATE

Los dwState de y dwStateMask contienen datos válidos.

dwState

Contiene un conjunto de marcas que indican el estado del elemento. Puede ser cero o una combinación de uno o varios de los valores siguientes.

DSBS_CHECKED

Si se establece esta marca, se selecciona el elemento. De lo contrario, el elemento no está seleccionado. Esta marca no se admite actualmente.

DSBS_HIDDEN

Si se establece esta marca, el elemento está oculto. De lo contrario, el elemento está visible.

DSBS_ROOT

Si se establece esta marca, el elemento es un elemento raíz. De lo contrario, el elemento no es un elemento raíz.

dwStateMask

Contiene un conjunto de marcas que indican qué marcas del miembro dwState contienen datos válidos. Puede ser cero o una combinación de uno o varios de los valores siguientes. Por ejemplo, si dwStateMask tiene establecida la marca DSBS_HIDDEN y dwState no tiene establecida la marca DSBS_HIDDEN, el elemento es visible. Si dwStateMask no tiene establecida la marca DSBS_HIDDEN, se debe omitir la marca de DSBS_HIDDEN en dwState.

DSBS_CHECKED

La marca DSBS_CHECKED del miembro dwState de contiene datos válidos.

DSBS_HIDDEN

La marca DSBS_HIDDEN del miembro dwState de contiene datos válidos.

DSBS_ROOT

La marca DSBS_ROOT del miembro dwState contiene datos válidos.

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

Puntero a una cadena terminada en null que contiene el nombre para mostrar del elemento. El nombre para mostrar de un elemento se puede cambiar copiando el nuevo nombre para mostrar en este miembro, estableciendo la marca DSBF_DISPLAYNAME en el miembro dwMask y devolviendo un valor distinto de cero de BFFCallBack.

szIconLocation[MAX_PATH]

Puntero a una cadena terminada en NULL que contiene el nombre de un archivo .exe, .dllo .ico que contiene el icono que se va a mostrar para el elemento. Puede ser cualquier tipo de archivo que se pueda pasar a la función de ExtractIcon. El índice de este icono se especifica en iIconResID. Para modificar el icono que se muestra para el elemento, copie el nombre del archivo de origen del icono en este miembro, establezca iIconResID en el índice de base cero del icono, establezca la marca DSBF_ICONLOCATION en el miembro dwMask y devuelva un valor distinto de cero de BFFCallBack.

iIconResID

Contiene el índice de base cero del icono que se va a mostrar para el elemento.

Nota Este no es el identificador de recursos del icono.

 

Observaciones

Nota

El encabezado dsclient.h define DSBITEM como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
servidor mínimo admitido	Windows Server 2008
encabezado de	dsclient.h

Consulte también

BFFCallBack

DsBrowseForContainer

ExtractIcon