Estructura DSBROWSEINFOA (dsclient.h)
La estructura DSBROWSEINFO se usa con la función DsBrowseForContainer para proporcionar y devolver datos sobre el cuadro de diálogo explorador de contenedores de Active Directory.
Sintaxis
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;
Miembros
cbStruct
Contiene el tamaño, en bytes, de la estructura DSBROWSEINFO . La función DsBrowseForContainer la usa para fines de control de versiones.
hwndOwner
Identificador de la ventana utilizada como elemento primario del cuadro de diálogo del explorador de contenedores.
pszCaption
Puntero a una cadena terminada en null que contiene el subtítulo del cuadro de diálogo. Si este miembro es NULL, se usa un subtítulo predeterminado.
pszTitle
Puntero a una cadena terminada en null que contiene texto adicional que se mostrará en el cuadro de diálogo encima del control de árbol. Si este miembro es NULL, no se muestra ningún texto adicional.
pszRoot
Puntero a una cadena Unicode terminada en null que contiene ADsPath del contenedor colocado en la raíz del cuadro de diálogo. El usuario no puede navegar por encima de este nivel mediante el cuadro de diálogo.
pszPath
Puntero a una cadena Unicode terminada en null que recibe ADsPath del contenedor seleccionado en el cuadro de diálogo. Esta cadena siempre estará terminada en null incluso si cchPath no es lo suficientemente grande como para contener toda la ruta de acceso. Si dwFlags contiene la marca DSBI_EXPANDONOPEN , este miembro contiene ADsPath del contenedor que se debe seleccionar inicialmente en el cuadro de diálogo.
cchPath
Contiene el tamaño, en caracteres WCHAR , del búfer pszPath .
dwFlags
Contiene un conjunto de marcas que definen el comportamiento del cuadro de diálogo. Puede ser cero o una combinación de uno o varios de los valores siguientes.
DSBI_NOBUTTONS (1 (0x1))
Los + botones y - no se muestran en el cuadro de diálogo.
DSBI_NOLINES (2 (0x2))
No se muestran las líneas que conectan los objetos del cuadro de diálogo.
DSBI_NOLINESATROOT (4 (0x4))
No se muestran las líneas y botones situados encima de los objetos raíz.
DSBI_CHECKBOXES (256 (0x100))
Hace que se coloque una casilla junto a cada elemento del árbol. El usuario puede usar el mouse para activar y desactivar esta casilla. Actualmente, esto tiene un uso limitado porque no hay ninguna manera de establecer o obtener el estado de comprobación de un elemento.
DSBI_NOROOT (65536 (0x10000))
El objeto raíz, especificado por pszRoot, no se muestra y los objetos secundarios inmediatos de la raíz se muestran en la raíz del árbol. Esta marca no tiene ningún efecto si pszRoot es NULL o si este miembro contiene DSBI_ENTIREDIRECTORY.
DSBI_INCLUDEHIDDEN (131072 (0x20000))
Incluya objetos ocultos en el cuadro de diálogo.
DSBI_EXPANDONOPEN (262144 (0x40000))
Cuando se abra el cuadro de diálogo, el contenedor especificado en pszPath estará visible y seleccionado.
DSBI_ENTIREDIRECTORY (589824 (0x90000))
Incluye todos los dominios de confianza en el servidor especificados en pszRoot o, de forma predeterminada, el dominio en el que el usuario ha iniciado sesión.
DSBI_RETURN_FORMAT (1048576 (0x100000))
Indica que el miembro dwReturnFormat es válido. Si no se establece esta marca, el formato de ruta de acceso tiene como valor predeterminado X.500.
DSBI_HASCREDENTIALS (2097152 (0x200000))
pUserName y pPassword se usan para las credenciales de acceso. De lo contrario, si este miembro no contiene DSBI_SIMPLEAUTHENTICATE, el cuadro de diálogo usa el contexto de seguridad del subproceso que realiza la llamada.
DSBI_IGNORETREATASLEAF (4194304 (0x400000))
Al determinar si el objeto se muestra en el cuadro de diálogo, se omite el especificador de pantalla treatAsLeaf .
DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))
Indica que no se requiere autenticación segura al llamar a ADsOpenObject.
DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))
Indica que pszObjectClass y cchObjectClass son válidos y deben rellenarse.
DSBI_DONTSIGNSEAL (33554432 (0x2000000))
Indica que la firma y el sellado no se usarán al comunicarse con el servicio de directorio.
pfnCallback
Puntero a una función de devolución de llamada BFFCallBack definida por la aplicación que recibe notificaciones del cuadro de diálogo del explorador de contenedores. Establezca este miembro en NULL si no se usa.
lParam
Contiene un valor de 32 bits definido por la aplicación pasado como parámetro lpData en todas las llamadas a pfnCallback. Este miembro se omite si pfnCallback es NULL.
dwReturnFormat
Contiene uno de los valores de ADS_FORMAT_ENUM que especifica el formato que aceptará la ruta de acceso ADSI devuelta en pszPath .
pUserName
Puntero a una cadena Unicode que contiene el nombre de usuario usado para las credenciales. Este miembro se omite si dwFlags no tiene establecida la marca DSBI_HASCREDENTIALS . Si este miembro es NULL, se usa el nombre de usuario que ha iniciado sesión actualmente.
pPassword
Puntero a una cadena Unicode que contiene la contraseña usada para las credenciales. Este miembro se omite si dwFlags no tiene establecida la marca DSBI_HASCREDENTIALS . Si este miembro es NULL, se usa la contraseña del usuario que ha iniciado sesión actualmente.
pszObjectClass
Puntero a un búfer de cadena Unicode que recibe la cadena de clase del seleccionado. Este miembro se omite si dwFlags no tiene establecida la marca DSBI_RETURNOBJECTCLASS .
cchObjectClass
Contiene el tamaño, en caracteres WCHAR , del búfer pszObjectClass .
Comentarios
Nota:
El encabezado dsclient.h define DSBROWSEINFO 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 Convenciones para prototipos de función.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | dsclient.h |