ITnef::AddProps
適用対象: Outlook 2013 | Outlook 2016
呼び出し元のサービス プロバイダーまたはゲートウェイがメッセージまたは添付ファイルのカプセル化にプロパティを追加できるようにします。
HRESULT AddProps(
ULONG ulFlags,
ULONG ulElemID,
LPVOID lpvData,
LPSPropTagArray lpPropList
);
パラメーター
ulFlags
[in]カプセル化にプロパティを含めるか、カプセル化から除外する方法を制御するフラグのビットマスク。 次のフラグを設定できます。
TNEF_PROP_ATTACHMENTS_ONLY
メッセージ内の添付ファイルの一部である lpPropList パラメーターのプロパティのみをエンコードします。
TNEF_PROP_CONTAINED
ulElemID パラメーターで指定された添付ファイルのプロパティのみをエンコードします。 lpvData パラメーターが NULL でない場合、指すデータは、PR_ATTACH_TRANSPORT_NAME (PidTagAttachTransportName) プロパティによって示されるファイル内の添付ファイルのカプセル化に書き込まれます。
TNEF_PROP_CONTAINED_TNEF
ulElemID パラメーターで指定されたメッセージまたは添付ファイルからのプロパティのみをエンコードします。 このフラグが設定されている場合、 lpvData の値は IStream ポインターである必要があります。
TNEF_PROP_EXCLUDE
lpPropList パラメーターで指定されていないすべてのプロパティをエンコードします。
TNEF_PROP_INCLUDE
lpPropList で指定されたすべてのプロパティをエンコードします。
TNEF_PROP_MESSAGE_ONLY
メッセージ自体の一部である lpPropList で指定されたプロパティのみをエンコードします。
ulElemID
[in]添付ファイルの PR_ATTACH_NUM (PidTagAttachNumber) プロパティ。親メッセージ内の添付ファイルを一意に識別する数値を含みます。 ulElemID パラメーターは、添付ファイルに対して特別な処理が要求されるときに使用されます。 ulFlags パラメーターに TNEF_PROP_CONTAINED または TNEF_PROP_CONTAINED_TNEF フラグが設定されていない限り、ulElemID パラメーターは 0 にする必要があります。
lpvData
[in] ulElemID で指定された添付ファイルのデータを置き換えるために使用される添付ファイル データへのポインター。 lpvData パラメーターは、ulFlags でTNEF_PROP_CONTAINEDまたはTNEF_PROP_CONTAINED_TNEFが設定されていない限り NULL にする必要があります。
lpPropList
[in]カプセル化に含める、またはカプセル化から除外するプロパティの一覧へのポインター。
戻り値
S_OK
�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B
注釈
トランスポート プロバイダー、メッセージ ストア プロバイダー、およびゲートウェイは 、ITnef::AddProps メソッドを呼び出して、メッセージまたは添付ファイルの Transport-Neutral カプセル化形式 (TNEF) 処理に含める、または除外するプロパティを一覧表示します。 プロバイダーまたはゲートウェイは、連続する呼び出しを使用して、追加およびエンコードするプロパティの一覧を指定したり、エンコードから除外したりできます。 プロバイダーとゲートウェイは 、AddProps を 使用して、特別な処理の添付ファイルに関する情報を提供することもできます。
AddProps は、 OpenTnefStream 関数または OpenTnefStreamEx 関数のTNEF_ENCODE フラグで開かれた TNEF オブジェクトに対してのみサポートされます。
ITnef::Finish メソッドが呼び出されるまで、AddProps に対して実際の TNEF エンコードは行われません。 この機能は、 AddProps に渡されるポインターは 、Finish の呼び出しが行われるまで有効なままである必要があることを意味します。 その時点で、 AddProps 呼び出しで渡されたすべてのオブジェクトとデータを解放または解放できます。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| File.cpp |
SaveToTNEF |
MFCMAPI では 、ITnef::AddProps メソッドを使用して、メッセージから TNEF ストリームにプロパティをコピーします。 |