Compartir a través de

Función DsBindA (ntdsapi.h)

  • Artículo

La función DsBind se enlaza a un controlador de dominio. DsBind usa las credenciales de proceso predeterminadas para enlazar al 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. Opcionalmente, cualquier tipo 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 la sección 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 la sección Comentarios.

[out] phDS

Dirección de un valor HANDLE 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 si 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.

Comentarios

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

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

)		 (value) 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 ntdsapi.h
Library Ntdsapi.lib
Archivo DLL Ntdsapi.dll

Consulte también

DOMAIN_CONTROLLER_INFO

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

DsBindWithCred

DsGetDcName

DsUnBind