IMAPIStatus::ChangePassword
Hace referencia a: Outlook 2013 | Outlook 2016
Modifica la contraseña de un proveedor de servicios sin mostrar una interfaz de usuario. Este método se admite opcionalmente en los objetos de estado que implementan los proveedores de servicios.
HRESULT ChangePassword(
LPSTR lpOldPass,
LPSTR lpNewPass,
ULONG ulFlags
);
Parameters
lpOldPass
[in] Puntero a la contraseña antigua.
lpNewPass
[in] Puntero a la nueva contraseña.
ulFlags
[in] Máscara de bits de marcas que controla el formato de las contraseñas. Se puede establecer la marca siguiente:
MAPI_UNICODE
Las contraseñas están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las contraseñas están en formato ANSI.
Valor devuelto
S_OK
La modificación de contraseña se realizó correctamente.
MAPI_E_NO_ACCESS
La contraseña antigua a la que apunta lpOldPass no es válida.
MAPI_E_NO_SUPPORT
El objeto status no admite esta operación, como se indica en la ausencia de la marca de STATUS_CHANGE_PASSWORD en la propiedad PR_RESOURCE_METHODS del objeto de estado (PidTagResourceMethods).
Comentarios
No todos los objetos de estado admiten el método IMAPIStatus::ChangePassword . Solo lo admiten los proveedores de servicios que requieren que los clientes escriban una contraseña. Ninguno de los objetos de estado que implementa MAPI admite la operación de cambio de contraseña.
ChangePassword modifica una contraseña mediante programación, sin interacción del usuario.
Notas a los implementadores
Los proveedores de transporte remoto implementan ChangePassword como se especifica aquí. No hay consideraciones especiales.