Função DsMakePasswordCredentialsA (ntdsapi.h)

Artigo
08/25/2023

A função DsMakePasswordCredentials constrói um identificador de credencial adequado para uso com a função DsBindWithCred .

Sintaxe

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

Parâmetros

[in] User

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome de usuário a ser usado para as credenciais.

[in] Domain

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o domínio do qual o usuário é membro.

[in] Password

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a senha a ser usada para as credenciais.

[out] pAuthIdentity

Ponteiro para um valor RPC_AUTH_IDENTITY_HANDLE que recebe o identificador de credencial. Esse identificador é usado em uma chamada subsequente para DsBindWithCred. Esse identificador deve ser liberado com a função DsFreePasswordCredentials quando não for mais necessário.

Retornar valor

Retorna um código de erro do Windows, incluindo o seguinte.

Comentários

Um identificador de credencial nulo e padrão será criado se Usuário, Domínio e Senha forem todos NULL. Caso contrário, o usuário deverá estar presente. O parâmetro Domain pode ser NULL quando o Usuário é totalmente qualificado, como um usuário no formato UPN; por exemplo, "someone@fabrikam.com".

Quando o identificador retornado em pAuthIdentity é passado para DsBindWithCred, DsUnBind deve ser chamado antes de liberar o identificador com DsFreePasswordCredentials. A sequência normal é:

Chame DsMakePasswordCredentials para obter o identificador de credencial.
Chame DsBindWithCred e passe o identificador de credencial.
Chame DsUnbind quando a associação não for mais necessária.
Chame DsFreePasswordCredentials para liberar o identificador de credencial.

Observação

O cabeçalho ntdsapi.h define DsMakePasswordCredentials como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	ntdsapi.h
Biblioteca	Ntdsapi.lib
DLL	Ntdsapi.dll