Compartilhar via

IMAPIOffline::SetCurrentState

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Define o estado atual de um objeto offline como online ou offline.

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

Parâmetros

ulFlags

[in] Modifica o comportamento dessa chamada. Os valores com suporte são:

MAPIOFFLINE_FLAG_BLOCK

A configuração de ulFlags para esse valor bloqueará a chamada SetCurrentState até que a alteração de estado seja concluída. Por padrão, a transição ocorre de forma assíncrona. Quando a transição estiver ocorrendo de forma assíncrona, todas as chamadas SetCurrentState retornarão E_PENDING até que a alteração seja concluída.

MAPIOFFLINE_FLAG_DEFAULT

Define o estado atual sem bloqueio.

Ulmask

[in] A parte do estado a ser alterada. O único valor com suporte é MAPIOFFLINE_STATE_OFFLINE_MASK.

ulState

[in] O estado para o qual mudar. Deve ser um desses dois valores:

MAPIOFFLINE_STATE_ONLINE

MAPIOFFLINE_STATE_OFFLINE

Preservado

Esse parâmetro é reservado para uso interno do Outlook e não tem suporte.

Valor de retorno

S_OK

O estado do objeto offline foi alterado com êxito.

E_PENDING

Isso indica que o estado do objeto offline está mudando assíncronamente. Isso ocorre quando ulFlags é definido como MAPIOFFLINE_FLAG_BLOCK em uma chamada SetCurrentState anterior e qualquer chamada setCurrentState subsequente retornará esse valor até que a alteração de estado assíncrona seja concluída.

Confira também

IMAPIOffline::GetCapabilities
Constantes MAPIIMAPIOffline::GetCurrentState