Función DsBindA (ntdsapi.h)

Artículo
02/29/2024

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