次の方法で共有

IMAPIOffline::SetCurrentState

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

オフライン オブジェクトの現在の状態をオンラインまたはオフラインに設定します。

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

パラメーター

ulFlags

[in]この呼び出しの動作を変更します。 サポートされている値を次に示します。

MAPIOFFLINE_FLAG_BLOCK

ulFlags をこの値に設定すると、状態の変更が完了するまで SetCurrentState 呼び出しがブロックされます。 既定では、移行は非同期的に行われます。 遷移が非同期的に実行されている場合、 すべての SetCurrentState 呼び出しは、変更が完了するまで E_PENDING を返します。

MAPIOFFLINE_FLAG_DEFAULT

ブロックせずに現在の状態を設定します。

ulMask

[in]変更する状態の部分。 サポートされている値はMAPIOFFLINE_STATE_OFFLINE_MASKのみです。

ulState

[in]変更する状態。 次の 2 つの値のいずれかである必要があります。

MAPIOFFLINE_STATE_ONLINE

MAPIOFFLINE_STATE_OFFLINE

保存

このパラメーターは Outlook の内部使用のために予約されており、サポートされていません。

戻り値

S_OK

オフライン オブジェクトの状態が正常に変更されました。

E_PENDING

これは、オフライン オブジェクトの状態が非同期的に変化していることを示します。 これは、 ulFlags が以前の SetCurrentState 呼び出しでMAPIOFFLINE_FLAG_BLOCKに設定されている場合に発生し、後続の SetCurrentState 呼び出しは非同期状態の変更が完了するまでこの値を返します。

関連項目

IMAPIOffline::GetCapabilities
IMAPIOffline::GetCurrentStateMAPI 定数