Función DsBrowseForContainerA (dsclient.h)

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

Sintaxis

int DsBrowseForContainerA(
  [in] PDSBROWSEINFOA pInfo
);

Parámetros

[in] pInfo

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

Valor devuelto

La función devuelve uno de los siguientes valores.

Observaciones

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 del DSBROWSEINFO estructura. Si el usuario hace clic en el pulsador o hace doble clic en un objeto, se devuelve IDOK y se devuelve pszPath contiene ADsPath del objeto seleccionado. Si el usuario cancela el cuadro de diálogo, DsBrowseForContainer devuelve IDCANCEL.

El miembro pszRoot contiene un ADsPath, que requiere el siguiente formulario.

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 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 de 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 tal como se especifica en la estructura DSBROWSEINFO de . 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, vea 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
servidor mínimo admitido	Windows Server 2008
de la plataforma de destino de	Windows
encabezado de	dsclient.h
biblioteca de	Dsuiext.lib
DLL de	Dsuiext.dll

Consulte también

BFFCallBack

DSBROWSEINFO de