ITnef::OpenTaggedBody
適用対象: Outlook 2013 | Outlook 2016
カプセル化されたメッセージのテキストでストリーム インターフェイスを開きます。
HRESULT OpenTaggedBody(
LPMESSAGE lpMessage,
ULONG ulFlags,
LPSTREAM FAR * lppStream
);
パラメーター
lpMessage
[in]ストリームが関連付けられているメッセージへのポインター。 このメッセージは、OpenTnefStream または OpenTnefStreamEx 関数の呼び出しで渡されるメッセージと同じである必要はありません。
ulFlags
[in]ストリーム インターフェイスの開き方を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_CREATE
プロパティが現在のメッセージに存在しない場合は、作成する必要があります。 プロパティが存在する場合は、プロパティ内の現在のデータを、Transport-Neutral カプセル化形式 (TNEF) ストリームのデータに置き換える必要があります。 実装で MAPI_CREATE フラグを設定する場合は、MAPI_MODIFY フラグも設定する必要があります。
MAPI_MODIFY
読み取り/書き込みアクセス許可を要求します。 既定のインターフェイスは読み取り専用です。 MAPI_MODIFYは、MAPI_CREATEが設定されるたびに設定する必要があります。
lppStream
[out]渡されたカプセル化されたメッセージの PR_BODY (PidTagBody) プロパティのテキストを含み、 IStream インターフェイスをサポートするストリーム オブジェクトへのポインター。
戻り値
S_OK
呼び出しは成功し、期待される値または値を返しました。
注釈
トランスポート プロバイダー、メッセージ ストア プロバイダー、およびゲートウェイは 、ITnef::OpenTaggedBody メソッドを呼び出して、カプセル化されたメッセージのテキスト (つまり TNEF オブジェクト上) でストリーム インターフェイスを開きます。
OpenTaggedBody は、その処理の一環として、メッセージ テキスト内の添付ファイルまたは OLE オブジェクトの位置を示す添付ファイル タグを挿入または解析します。 添付ファイル タグの形式は次のとおりです。
[[添付ファイル名:ninattachment container name]]
添付ファイル名は添付ファイル オブジェクトを表します。n は、OpenTnefStream または OpenTnefStreamEx 関数の lpKey パラメーターで渡された値からインクリメントして、シーケンスの一部である添付ファイルを識別する数値です。および 添付ファイル コンテナー名 は、添付ファイル オブジェクトが存在する物理コンポーネントを表します。
OpenTaggedBody は メッセージ テキストを読み取り、添付ファイル オブジェクトがテキストに最初に表示された場所に添付ファイル タグを挿入します。 元のメッセージ テキストは変更されません。
タグを持つメッセージがストリームに渡されると、タグは削除され、添付ファイル オブジェクトはストリーム内のタグの位置に再配置されます。