Função DsMakePasswordCredentialsA (ntdsapi.h)
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 |
Confira também
Funções de gerenciamento de replicação e controlador de domínio