Compartir a través de


Función DsBindA (ntdsapi.h)

La función DsBind enlaza a un controlador de dominio.DsBind usa las credenciales de proceso predeterminadas para enlazar con el controlador de dominio. Para especificar credenciales alternativas, use la función DsBindWithCred.

Sintaxis

NTDSAPI DWORD DsBindA(
  [in, optional] LPCSTR DomainControllerName,
  [in, optional] LPCSTR DnsDomainName,
  [out]          HANDLE *phDS
);

Parámetros

[in, optional] DomainControllerName

Puntero a una cadena terminada en null que contiene el nombre del controlador de dominio al que se va a enlazar. Este nombre puede ser el nombre del controlador de dominio o el nombre DNS completo del controlador de dominio. Cualquiera de los tipos de nombre puede ir precedido de dos caracteres de barra diagonal inversa. Todos los ejemplos siguientes representan nombres de controlador de dominio con formato correcto:

  • "FAB-DC-01"
  • "\\FAB-DC-01"
  • "FAB-DC-01.fabrikam.com"
  • "\\FAB-DC-01.fabrikam.com"
Este parámetro puede ser null. Para obtener más información, vea Comentarios.

[in, optional] DnsDomainName

Puntero a una cadena terminada en null que contiene el nombre DNS completo del dominio al que se va a enlazar. Este parámetro puede ser null. Para obtener más información, vea Comentarios.

[out] phDS

Dirección de un handle valor que recibe el identificador de enlace. Para cerrar este identificador, páselo a la función DsUnBind.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente o un código de error de Windows o RPC de lo contrario. A continuación se muestran los códigos de error más comunes.

Observaciones

El comportamiento de la función DsBind viene determinado por el contenido de los parámetros DomainControllerName de y DnsDomainName. En la lista siguiente se describe el comportamiento de esta función en función del contenido de estos parámetros.

domainControllerName de DnsDomainName Descripción
NULL NULL DsBind intentará enlazar a un servidor de catálogo global en el bosque del equipo local.
(valor) NULL DsBind intentará enlazar al controlador de dominio especificado por el parámetro DomainControllerName .
NULL (valor) DsBind intentará enlazar con cualquier controlador de dominio del dominio especificado por parámetro DnsDomainName.
(valor)

)
(valor) El parámetro domainControllerName tiene prioridad. DsBind intentará enlazar al controlador de dominio especificado por el parámetro DomainControllerName .
 

Nota

El encabezado ntdsapi.h define DsBind 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 ntdsapi.h
biblioteca de Ntdsapi.lib
DLL de Ntdsapi.dll

Consulte también

DOMAIN_CONTROLLER_INFO

controlador de dominio y funciones de administración de replicación

DsBindWithCred

DsGetDcName

DsUnBind