IMAPIStatus::ChangePassword
Aplica-se a: Outlook 2013 | Outlook 2016
Modifica a senha de um provedor de serviços sem exibir uma interface do usuário. Opcionalmente, esse método tem suporte em objetos status que os provedores de serviços implementam.
HRESULT ChangePassword(
LPSTR lpOldPass,
LPSTR lpNewPass,
ULONG ulFlags
);
Parâmetros
lpOldPass
[in] Um ponteiro para a senha antiga.
lpNewPass
[in] Um ponteiro para a nova senha.
ulFlags
[in] Um bitmask de sinalizadores que controla o formato das senhas. O seguinte sinalizador pode ser definido:
MAPI_UNICODE
As senhas estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as senhas estarão no formato ANSI.
Valor de retorno
S_OK
A modificação de senha foi bem-sucedida.
MAPI_E_NO_ACCESS
A senha antiga apontada por lpOldPass é inválida.
MAPI_E_NO_SUPPORT
O objeto status não dá suporte a essa operação, conforme indicado pela ausência do sinalizador de STATUS_CHANGE_PASSWORD na propriedade PR_RESOURCE_METHODS do objeto status (PidTagResourceMethods).
Comentários
Nem todos os objetos status dão suporte ao método IMAPIStatus::ChangePassword. Ele é compatível apenas com provedores de serviços que exigem que os clientes insiram uma senha. Nenhum dos objetos status que o MAPI implementa dá suporte à operação de alteração de senha.
ChangePassword modifica uma senha de forma programática, sem interação do usuário.
Observações para implementadores
Os provedores de transporte remoto implementam o ChangePassword conforme especificado aqui. Não há considerações especiais.