Función DsBindWithCredA (ntdsapi.h)

Artículo
02/29/2024

La función DsBindWithCred se enlaza a un controlador de dominio mediante las credenciales especificadas.

Sintaxis

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

Parámetros

[in, optional] DomainControllerName

Puntero a una cadena terminada en null que contiene el nombre DNS completo del dominio que se va a enlazar. Para obtener más información sobre este parámetro, vea la descripción DomainControllerName en el tema DsBind .

[in, optional] DnsDomainName

Puntero a una cadena terminada en null que contiene el nombre DNS completo del dominio al que se va a enlazar. Para obtener más información sobre este parámetro, consulte la descripción DnsDomainName en el tema DsBind .

Este parámetro es necesario para proteger una autenticación Kerberos.

[in, optional] AuthIdentity

Contiene un valor de RPC_AUTH_IDENTITY_HANDLE que representa las credenciales que se van a usar para el enlace. The

La función DsMakePasswordCredentials se usa para obtener este valor. Si este parámetro es NULL, se usan las credenciales del subproceso que realiza la llamada.

Se debe llamar a DsUnBind antes de liberar este identificador con la función DsFreePasswordCredentials.

[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

Nota

El encabezado ntdsapi.h define DsBindWithCred 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