IXPLogon::OpenStatusEntry
適用対象: Outlook 2013 | Outlook 2016
トランスポート プロバイダーの状態オブジェクトを開きます。
HRESULT OpenStatusEntry(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPMAPISTATUS FAR * lppEntry
);
パラメーター
lpInterface
[in]トランスポート ログオン オブジェクトのインターフェイス識別子 (IID) へのポインター。 NULL を渡すと、 IMAPIStatus インターフェイスが返されます。 lpInterface パラメーターは、 オブジェクトのインターフェイスの識別子に設定することもできます。
ulFlags
[in]状態オブジェクトを開く方法を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_MODIFY
読み取り/書き込みアクセス許可を要求します。 既定のインターフェイスは読み取り専用です。
lpulObjType
[out]開いているオブジェクトの型へのポインター。
lppEntry
[out]開いている状態オブジェクトへのポインターへのポインター。
戻り値
S_OK
呼び出しは成功し、期待される値または値を返しました。
注釈
MAPI スプーラーは、クライアント アプリケーションがトランスポート プロバイダーの状態テーブル行のエントリ識別子に対して OpenEntry メソッドを呼び出すときに、IXPLogon::OpenStatusEntry メソッドを呼び出します。 OpenStatusEntry は、この特定のトランスポート プロバイダー ログオンに関連付けられた IMAPIStatus インターフェイスを持つオブジェクトを開きます。 このオブジェクトは、クライアント アプリケーションが IMAPIStatus メソッドを呼び出せるようにするために使用されます (たとえば、 IMAPIStatus::SettingsDialog メソッドを使用してログオン セッションを再構成したり、 IMAPIStatus::ValidateState メソッドを使用してログオン セッションの状態を検証したりします)。