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
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"
[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
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
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 |
|
NULL | (valor) | DsBind intentará enlazar con cualquier controlador de dominio del dominio especificado por parámetro DnsDomainName. |
(valor)) | (valor) |
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
controlador de dominio y funciones de administración de replicación