Función DsMakePasswordCredentialsA (ntdsapi.h)

Artículo
02/29/2024

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

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 el usuario es miembro.

[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.

Comentarios

Se crea un identificador de credenciales predeterminado null si User, Domain y Password son null. De lo contrario, el usuario debe estar presente. El parámetro Domain puede ser NULL cuando el 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:

Llame a DsMakePasswordCredentials para obtener el identificador de credencial.
Llame a DsBindWithCred y pase el identificador de credenciales.
Llame a DsUnbind cuando el enlace ya no sea necesario.
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 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