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
hwndOwner
Identificador de la ventana usada como elemento primario del cuadro de diálogo del explorador de contenedores.
pszCaption
Puntero a una cadena terminada en null que contiene el título del cuadro de diálogo. Si este miembro es NULL, se usa un tí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 el ADsPath del contenedor seleccionado en el cuadro de diálogo. Esta cadena siempre será 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 de WCHAR, del búfer de 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))
Las líneas y botones situados encima de los objetos raíz no se muestran.
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 treatAsLeaf especificador de presentación.
DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))
Indica que no se requiere autenticación segura al llamar a ADsOpenObject.
DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))
Indica que el pszObjectClass de
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 un BFFCallBack definido por la aplicación función de devolución de llamada 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 que se pasa como parámetro de 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 de pszObjectClass.
Observaciones
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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| servidor mínimo admitido | Windows Server 2008 |
| encabezado de |
dsclient.h |