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

Consulte también

ADS_FORMAT_ENUM

ADsOpenObject

BFFCallBack

DsBrowseForContainer