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 explorador del contenedor 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 miembros szIconLocation e iIconResID contienen datos válidos.
DSBF_STATE
Los miembros dwState 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 la marca DSBS_HIDDEN establecida 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 DSBS_HIDDEN en dwState .
DSBS_CHECKED
La marca DSBS_CHECKED del miembro dwState contiene datos válidos.
DSBS_HIDDEN
La marca DSBS_HIDDEN del miembro dwState 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 .exe, .dll o .ico archivo 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 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.
Comentarios
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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows Vista |
Servidor mínimo compatible | Windows Server 2008 |
Encabezado | dsclient.h |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de