Compartir a través de


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.

Vea también

Propiedad canónica PidTagResourceMethods

IMAPIStatus : IMAPIProp