IXPLogon::ValidateState
適用対象: Outlook 2013 | Outlook 2016
トランスポート プロバイダーの外部状態を確認します。
HRESULT ValidateState(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
パラメーター
ulUIParam
[in]このメソッドが表示するダイアログ ボックスまたはウィンドウの親ウィンドウへのハンドル。
ulFlags
[in]状態チェックの実行方法と状態の結果を制御するフラグのビットマスクチェック。 次のフラグを設定できます。
ABORT_XP_HEADER_OPERATION
ユーザーは通常、ダイアログ ボックスの [キャンセル] ボタンをクリックして操作を 取り消 しました。 トランスポート プロバイダーには、操作の作業を続行するか、操作を中止してMAPI_E_USER_CANCELEDを返すオプションがあります。
CONFIG_CHANGED
MAPI スプーラーが IXPLogon::AddressTypes メソッドを呼び出すようにして、現在読み込まれているトランスポート プロバイダーの状態を検証します。 このフラグにより、MAPI スプーラーは、クライアント アプリケーションに強制的にログオフして再度ログオンすることなく、重要なトランスポート プロバイダーのエラーを修正する機会も提供します。
FORCE_XP_CONNECT
ユーザーが接続操作を選択しました。 このフラグを REFRESH_XP_HEADER_CACHE フラグまたは PROCESS_XP_HEADER_CACHE フラグと共に使用すると、キャッシュなしで接続アクションが実行されます。
FORCE_XP_DISCONNECT
ユーザーが切断操作を選択しました。 このフラグをREFRESH_XP_HEADER_CACHEまたはPROCESS_XP_HEADER_CACHEで使用すると、キャッシュなしで切断アクションが実行されます。
PROCESS_XP_HEADER_CACHE
ヘッダー キャッシュ テーブル内のエントリを処理し、MSGSTATUS_REMOTE_DOWNLOAD フラグでマークされているすべてのメッセージをダウンロードし、MSGSTATUS_REMOTE_DELETE フラグでマークされたすべてのメッセージを削除する必要があります。 MSGSTATUS_REMOTE_DOWNLOADとMSGSTATUS_REMOTE_DELETEの両方が設定されているメッセージを移動する必要があります。
REFRESH_XP_HEADER_CACHE
メッセージ ヘッダーの新しい一覧をダウンロードし、すべてのメッセージ状態マーキング フラグをクリアする必要があります。
SUPPRESS_UI
トランスポート プロバイダーがユーザー インターフェイスを表示できないようにします。
戻り値
S_OK
呼び出しは成功し、期待される値または値を返しました。
MAPI_E_BUSY
別の操作が進行中です。完了を許可するか、この操作を試行する前に停止する必要があります。
MAPI_E_NO_SUPPORT
関連するリモート トランスポート プロバイダーはユーザー インターフェイスをサポートしていないため、クライアント アプリケーション自体にダイアログ ボックスが表示されます。
MAPI_E_USER_CANCEL
ユーザーは通常、ダイアログ ボックスの [キャンセル] ボタンをクリックして操作を 取り消 しました。
注釈
MAPI スプーラーは IXPLogon::ValidateState メソッドを呼び出して、status オブジェクトの IMAPIStatus::ValidateState メソッドの呼び出しをサポートします。 トランスポート プロバイダーは、MAPI スプーラーが現在のログオン セッションの状態オブジェクトを開き、そのオブジェクトに対して IMAPIStatus::ValidateState を呼び出した場合とまったく同じように、IXPLogon::ValidateState 呼び出しに応答する必要があります。
IMAPIStatus::ValidateState の実装をサポートするために、MAPI スプーラーは、プロファイル セッションで実行されているすべてのアクティブなトランスポート プロバイダーのすべてのログオン オブジェクトに対して IXPLogon::ValidateState を呼び出します。