OpenIMsgSession

適用対象: Outlook 2013 | Outlook 2016

作成し、その中に作成されたメッセージをグループにするメッセージ セッションを開きます。

プロパティ	値
ヘッダー ファイル:	Imessage.h
実装元:	MAPI
呼び出し元:	クライアント アプリケーションとサービス プロバイダー

SCODE OpenIMsgSession(
  LPMALLOC lpMalloc,
  ULONG ulFlags,
  LPMSGSESS FAR * lppMsgSess
);

パラメーター

lpMalloc

[in]OLE IMalloc インターフェイスを公開するメモリ アロケーター オブジェクトへのポインター。 MAPI では、OLE IStorage インターフェイスを操作するときに、この割り当て方法を使用する必要があります。

ulFlags

[����]�\�񂳂�Ă��܂��B0 �ɂ���K�v������܂��B

lppMsgSess

[out]返されたメッセージ セッション オブジェクトへのポインターへのポインター。

戻り値

S_OK

セッションが開かれました。

MAPI_E_INVALID_PARAMETER

lpMalloc または lppMsgSess は NULL です。

MAPI_E_INVALID_FLAGS

無効なフラグが渡されました。

MAPI_UNICODE

この関数を呼び出すとき、クライアントまたはサービス プロバイダーは、Unicode .msg ファイルを作成するMAPI_UNICODE フラグを設定します。 結果の Imessage ファイルは、PR_STORE_SUPPORT_MASKにSTORE_UNICODE_OKを表示し、Unicode プロパティをサポートします。

注釈

メッセージ セッションは、関連する MAPI IMessage : 基になる OLE IStorage オブジェクトの上に構築された IMAPIProp オブジェクトを処理するクライアント アプリケーションとサービス プロバイダーによって使用されます。 クライアントまたはプロバイダーは 、OpenIMsgSession 関数と CloseIMsgSession 関数を使用して、このようなメッセージの作成をメッセージ セッション内でラップします。 メッセージ セッションが開かれると、クライアントまたはプロバイダーは OpenIMsgOnIStg の呼び出しでポインターを渡して、新しい IMessage-on- IStorage オブジェクトを作成します。

メッセージ セッションでは、セッション中に作成されたすべての IMessage-on- IStorage オブジェクトと、メッセージのすべての添付ファイルおよびその他のプロパティが追跡されます。 クライアントまたはプロバイダーが CloseIMsgSession を呼び出すと、これらのオブジェクトがすべて閉じられます。 IMessage-on- IStorage オブジェクトを閉じる唯一の方法は、CloseIMsgSession を呼び出すことです。

OpenIMsgSession は、関連する複数のメッセージを OLE IStorage オブジェクトとして処理する機能を必要とするクライアントとプロバイダーによって使用されます。 このようなメッセージを一度に 1 つだけ開く場合、複数のメッセージを追跡する必要はなく、 OpenIMsgSession でメッセージ セッションを作成する理由もありません。

基になる OLE オブジェクトを扱うため、MAPI では OLE メモリ割り当てを使用する必要があります。 OLE 構造化ストレージ オブジェクトと OLE メモリ割り当ての詳細については、「 OLE とデータ転送」を参照してください。