Поделиться через

IMAPIOffline::SetCurrentState

  • Статья

Область применения: Outlook 2013 | Outlook 2016

Задает текущее состояние автономного объекта в режиме "в сети" или "вне сети".

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

Параметры

ulFlags

[в] Изменяет поведение этого вызова. Поддерживаются следующие значения:

MAPIOFFLINE_FLAG_BLOCK

Установка этого значения в ulFlags заблокирует вызов SetCurrentState до тех пор, пока не будет завершено изменение состояния. По умолчанию переход выполняется асинхронно. Когда переход выполняется асинхронно, все вызовы SetCurrentState будут возвращать E_PENDING до тех пор, пока изменение не будет завершено.

MAPIOFFLINE_FLAG_DEFAULT

Задает текущее состояние без блокировки.

ulMask

[в] Часть изменяемого состояния. Единственное поддерживаемое значение — MAPIOFFLINE_STATE_OFFLINE_MASK.

ulState

[в] Состояние, в которое необходимо изменить. Это должно быть одно из следующих двух значений:

MAPIOFFLINE_STATE_ONLINE

MAPIOFFLINE_STATE_OFFLINE

Сохранились

Этот параметр зарезервирован для внутреннего использования Outlook и не поддерживается.

Возвращаемое значение

S_OK

Состояние автономного объекта было успешно изменено.

E_PENDING

Это означает, что состояние автономного объекта изменяется асинхронно. Это происходит, когда ulFlags имеет значение MAPIOFFLINE_FLAG_BLOCK в более раннем вызове SetCurrentState , и любой последующий вызов SetCurrentState возвращает это значение до завершения асинхронного изменения состояния.

См. также

IMAPIOffline::GetCapabilities
Константы MAPI IMAPIOffline::GetCurrentState