Compartilhar via

Função ChangeAccountPasswordA (sspi.h)

  • Artigo

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 é compatível apenas com os provedores Microsoft Kerberos, Microsoft Negotiate e 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

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

Retornar valor

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

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

Comentários

Observação

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