Função DsMakePasswordCredentialsA (ntdsapi.h)

Artigo
11/20/2024

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 ela não for mais necessária.

Valor de retorno

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

Observações

Um identificador de credencial padrão e nulo será criado se User, Domain e Password estiverem todos NULL. Caso contrário, de usuário deve estar presente. O parâmetro Domain pode ser NULL quando User é 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
servidor com suporte mínimo	Windows Server 2008
da Plataforma de Destino	Windows
cabeçalho	ntdsapi.h
biblioteca	Ntdsapi.lib
de DLL	Ntdsapi.dll

Consulte também

Funções de gerenciamento de replicação e controlador de domínio

DsBindWithCred

DsFreePasswordCredentials

DsUnbind

RPC_AUTH_IDENTITY_HANDLE

Compartilhar via