ITnef::SetProps
適用対象: Outlook 2013 | Outlook 2016
元のメッセージまたは添付ファイルを変更せずに、カプセル化されたメッセージまたは添付ファイルの 1 つ以上のプロパティの値を設定します。
HRESULT SetProps(
ULONG ulFlags,
ULONG ulElemID,
ULONG cValues,
LPSPropValue lpProps
);
パラメーター
ulFlags
[in]プロパティ値の設定方法を制御するフラグのビットマスク。 次のフラグを設定できます。
TNEF_PROP_CONTAINED
ulElemID パラメーターで指定されたメッセージまたは添付ファイルからのプロパティのみをエンコードします。
ulElemID
[in]添付ファイルの PR_ATTACH_NUM (PidTagAttachNumber) プロパティ。親メッセージ内の添付ファイルを一意に識別する数値を含みます。
cValues
[in]lpProps パラメーターによって指される SPropValue 構造体のプロパティ値の数。
lpProps
[in]設定するプロパティのプロパティ値を含む SPropValue 構造体へのポインター。
戻り値
S_OK
呼び出しは成功し、期待される値または値を返しました。
注釈
トランスポート プロバイダー、メッセージ ストア プロバイダー、ゲートウェイは ITnef::SetProps メソッドを呼び出して、元のメッセージや添付ファイルを変更せずに、メッセージまたは添付ファイルのカプセル化に含めるプロパティを設定します。 この呼び出しで設定されたプロパティは、カプセル化されたメッセージ内の既存のプロパティをオーバーライドします。
SetProps は、 OpenTnefStream 関数または OpenTnefStreamEx 関数のTNEF_ENCODE フラグで開かれた TNEF オブジェクトに対してのみサポートされます。 この呼び出しでは、任意の数のプロパティを設定できます。
注:
ITnef::Finish メソッドが呼び出されるまで、SetProps の実際の TNEF エンコードは発生しません。 この機能は、 SetProps に渡されるポインターは 、Finish の呼び出しが行われるまで有効なままである必要があることを意味します。 その時点で、 SetProps 呼び出しに渡されるすべてのオブジェクトとデータを解放または解放できます。