Função ChangeAccountPasswordA (sspi.h)

Artigo
11/20/2024

A função ChangeAccountPassword altera a senha de uma conta de domínio do Windows usando o provedor de suporte de segurança especificado.

Essa função só tem suporte no Microsoft Kerberos, Microsoft Negotiatee provedores de microsoft NTLM.

Sintaxe

SECURITY_STATUS SEC_ENTRY ChangeAccountPasswordA(
  [in]      SEC_CHAR       *pszPackageName,
  [in]      SEC_CHAR       *pszDomainName,
  [in]      SEC_CHAR       *pszAccountName,
  [in]      SEC_CHAR       *pszOldPassword,
  [in]      SEC_CHAR       *pszNewPassword,
  [in]      BOOLEAN        bImpersonating,
  [in]      unsigned long  dwReserved,
  [in, out] PSecBufferDesc pOutput
);

Parâmetros

[in] pszPackageName

O nome do provedor a ser usado. O valor desse parâmetro deve ser "Kerberos", "Negotiate" ou "NTLM".

[in] pszDomainName

O domínio da conta para a qual alterar a senha.

[in] pszAccountName

O nome de usuário da conta para a qual alterar a senha.

[in] pszOldPassword

A senha antiga a ser alterada.

[in] pszNewPassword

A nova senha da conta especificada.

[in] bImpersonating

VERDADEIRO se o processo de chamada estiver em execução como o cliente; caso contrário, FALSE .

[in] dwReserved

Reservado. Deve ser definido como zero.

[in, out] pOutput

Na entrada, um ponteiro para uma estrutura SecBufferDesc. A estrutura SecBufferDesc deve conter um único buffer do tipo SECBUFFER_CHANGE_PASS_RESPONSE. Na saída, o membro pvBuffer dessa estrutura aponta para uma estrutura DOMAIN_PASSWORD_INFORMATION.

Valor de retorno

Se a função for bem-sucedida, a função retornará SEC_E_OK.

Se a função falhar, ela retornará um código de erro.

Observações

Nota

O cabeçalho sspi.h define ChangeAccountPassword 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. 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 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	sspi.h
biblioteca	Secur32.lib
de DLL	Secur32.dll

Compartilhar via