Compartir a través de

Función DsMakePasswordCredentialsA (ntdsapi.h)

  • Artículo

La función DsMakePasswordCredentials crea un identificador de credencial adecuado para su uso con la función DsBindWithCred de .

Sintaxis

NTDSAPI DWORD DsMakePasswordCredentialsA(
  [in]  LPCSTR                   User,
  [in]  LPCSTR                   Domain,
  [in]  LPCSTR                   Password,
  [out] RPC_AUTH_IDENTITY_HANDLE *pAuthIdentity
);

Parámetros

[in] User

Puntero a una cadena terminada en null que contiene el nombre de usuario que se va a usar para las credenciales.

[in] Domain

Puntero a una cadena terminada en null que contiene el dominio del que es miembro el usuario.

[in] Password

Puntero a una cadena terminada en null que contiene la contraseña que se va a usar para las credenciales.

[out] pAuthIdentity

Puntero a un valor de RPC_AUTH_IDENTITY_HANDLE que recibe el identificador de credenciales. Este identificador se usa en una llamada posterior a DsBindWithCred. Este identificador debe liberarse con la función DsFreePasswordCredentials cuando ya no sea necesario.

Valor devuelto

Devuelve un código de error de Windows, incluido lo siguiente.

Observaciones

Se crea un identificador de credenciales predeterminado null side usuario , dominio y contraseña son todos NULL. De lo contrario, de usuario debe estar presente. El parámetro Domain puede ser NULL cuando Usuario está completo, como un usuario en formato UPN; por ejemplo, "someone@fabrikam.com".

Cuando el identificador devuelto en pAuthIdentity se pasa a DsBindWithCred, se debe llamar a DsUnBind antes de liberar el identificador con DsFreePasswordCredentials. La secuencia normal es:

  1. Llame a DsMakePasswordCredentials para obtener el identificador de credenciales.
  2. Llame a DsBindWithCredy pase el identificador de credenciales.
  3. Llame a DsUnbind cuando el enlace ya no sea necesario.
  4. Llame a DsFreePasswordCredentials para liberar el identificador de credenciales.

Nota

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

DsBindWithCred

DsFreePasswordCredentials

DsUnbind

RPC_AUTH_IDENTITY_HANDLE