Compartir a través de

IMAPIOffline::SetCurrentState

  • Artículo

Hace referencia a: Outlook 2013 | Outlook 2016

Establece el estado actual de un objeto sin conexión en línea o sin conexión.

HRESULT SetCurrentState( 
    ULONG ulFlags, 
    ULONG ulMask, 
    ULONG ulState, 
    void* pReserved 
);

Parameters

ulFlags

[in] Modifica el comportamiento de esta llamada. Los valores admitidos son:

MAPIOFFLINE_FLAG_BLOCK

Si se establece ulFlags en este valor, se bloqueará la llamada a SetCurrentState hasta que se complete el cambio de estado. De forma predeterminada, la transición se realiza de forma asincrónica. Cuando la transición se produce de forma asincrónica, todas las llamadas a SetCurrentState devolverán E_PENDING hasta que se complete el cambio.

MAPIOFFLINE_FLAG_DEFAULT

Establece el estado actual sin bloqueo.

ulMask

[in] Parte del estado que se va a cambiar. El único valor admitido es MAPIOFFLINE_STATE_OFFLINE_MASK.

ulState

[in] Estado al que se va a cambiar. Debe ser uno de estos dos valores:

MAPIOFFLINE_STATE_ONLINE

MAPIOFFLINE_STATE_OFFLINE

Conservado

Este parámetro está reservado para uso interno de Outlook y no se admite.

Valor devuelto

S_OK

El estado del objeto sin conexión se ha cambiado correctamente.

E_PENDING

Esto indica que el estado del objeto sin conexión está cambiando de forma asincrónica. Esto ocurre cuando ulFlags se establece en MAPIOFFLINE_FLAG_BLOCK en una llamada a SetCurrentState anterior y cualquier llamada a SetCurrentState posterior devolverá este valor hasta que se complete el cambio de estado asincrónico.

Vea también

IMAPIOffline::GetCapabilities
CONSTANTES MAPI IMAPIOffline::GetCurrentState