Función DsBrowseForContainerA (dsclient.h)

La función DsBrowseForContainer muestra un cuadro de diálogo que se usa para buscar objetos de contenedor en Servicios de dominio de Active Directory.

Sintaxis

int DsBrowseForContainerA(
  [in] PDSBROWSEINFOA pInfo
);

Parámetros

[in] pInfo

Puntero a una estructura DSBROWSEINFO que contiene datos sobre cómo inicializar el cuadro de diálogo del explorador del contenedor y recibe datos sobre el objeto seleccionado.

Valor devuelto

La función devuelve uno de los valores siguientes.

Comentarios

El cuadro de diálogo muestra un selector de contenedores que se rellena con contenedores de una raíz determinada o que usa dominios de confianza. Si usa dominios de confianza, puede usar el dominio en el que el usuario ha iniciado sesión actualmente o puede usar un dominio alternativo especificado por la aplicación mediante el miembro pszRoot de la estructura DSBROWSEINFO . Si el usuario hace clic en el botón de inserción Aceptar o hace doble clic en un objeto, se devuelve IDOK y pszPath contiene ADsPath del objeto seleccionado. Si el usuario cancela el cuadro de diálogo, DsBrowseForContainer devuelve IDCANCEL.

El miembro pszRoot contiene una instancia de ADsPath, que requiere el siguiente formato.

LDAP://fabrikam.com/CN=Users,DC=Fabrikam,DC=com

DsBrowseForContainer usa esta ruta de acceso como raíz del árbol. El miembro pszRoot también se puede usar para especificar un dominio que tenga una relación de confianza con el dominio en el que el usuario haya iniciado sesión, de modo que el usuario pueda examinar el contenedor Usuarios del dominio alternativo. Si el miembro pszPath contiene una ruta de acceso, el cuadro de diálogo navegará desde pszRoot a través de los contenedores hasta que llegue al objeto especificado por pszPath.

La función DsBrowseForContainer admite una función de devolución de llamada como se especifica en la estructura DSBROWSEINFO . La función de devolución de llamada se puede usar para filtrar, modificar o actualizar la vista en función del cambio de selección, etc. Para obtener más información, consulte BFFCallBack.

Importante A partir de Windows Server 2003, la versión ANSI de esta función (DsBrowseForContainerA) no se implementa y siempre devuelve -1.

 

Ejemplos

En el ejemplo de código siguiente se elige un contenedor en el dominio en el que el usuario ha iniciado sesión. La vista también muestra todos los dominios de confianza.

void PickContainer(void)
{
    DSBROWSEINFOW dsbi = { 0 };
    WCHAR wszResult[MAX_PATH];
 
    dsbi.cbStruct = sizeof(dsbi);
    dsbi.pszCaption = L"The container picker";
    dsbi.pszTitle = L"Pick a container for this example.";
    dsbi.pszPath = wszResult;
    dsbi.cchPath = MAX_PATH;
    dsbi.dwFlags = DSBI_ENTIREDIRECTORY;

    int nReturn = DsBrowseForContainerW(&dsbi);
 
    if ( IDOK == nReturn )
    {
        // wszResult contains the resulting path
    }
}

Nota

El encabezado dsclient.h define DsBrowseForContainer 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

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	dsclient.h
Library	Dsuiext.lib
Archivo DLL	Dsuiext.dll

Consulte también

BFFCallBack

DSBROWSEINFO