ITnef::EncodeRecips
適用対象: Outlook 2013 | Outlook 2016
メッセージの Transport-Neutral カプセル化形式 (TNEF) データ ストリーム内のメッセージの受信者テーブルのビューをエンコードします。
HRESULT EncodeRecips(
ULONG ulFlags,
LPMAPITABLE lpRecipientTable
);
パラメーター
ulFlags
[����]�\��Ă��܂��B0 �ɂ���K�v������܂��B
lpRecipientTable
[in]ビューがエンコードされる受信者テーブルへのポインター。 lpRecipientTable パラメーターには NULL を指定できます。
戻り値
S_OK
呼び出しは成功し、期待される値または値を返しました。
注釈
トランスポート プロバイダー、メッセージ ストア プロバイダー、ゲートウェイは 、ITnef::EncodeRecips メソッドを呼び出して、特定の受信者テーブル ビューに対して TNEF エンコードを実行します。 TNEF エンコードは、たとえば、プロバイダーまたはゲートウェイで特定の列セット、並べ替え順序、または受信者テーブルの制限が必要な場合に便利です。
プロバイダーまたはゲートウェイは、 lpRecipientTable パラメーターでエンコードされるテーブル ビューを渡します。 TNEF 実装は、指定された列セット、並べ替え順序、制限、および位置を使用して、指定されたビューで受信者テーブルをエンコードします。 プロバイダーまたはゲートウェイが lpRecipientTable で NULL を渡す場合、TNEF は IMessage::GetRecipientTable メソッドを使用してエンコードされているメッセージから受信者テーブルを取得し、テーブルの現在の設定を使用してテーブルのすべての行を TNEF ストリームに処理します。
そのため、lpRecipientTable で NULL で EncodeRecips を呼び出すと、すべてのメッセージ受信者がエンコードされ、ulFlags パラメーターに TNEF_PROP_INCLUDE フラグを指定して ITnef::AddProps メソッドを呼び出し、lpPropList パラメーターで PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) プロパティを呼び出すのと同じです。
特定の受信者テーブル ビューをエンコードする必要がない限り、 EncodeRecips を呼び出す必要はほとんどありません。 外部メッセージング システムには、ほとんどの場合、受信者リストをエンコードする一般的なニーズを処理するのに十分な強力な受信者リストを処理するための機能があります。したがって、これらのシステムは、この目的のために TNEF をほとんど必要としません。