受信者リストの作成
適用対象: Outlook 2013 | Outlook 2016
受信者リストは、メッセージの宛先である各メッセージ受信者のプロパティ値構造体の配列を含む ADRLIST 構造体です。 受信者は、人間のユーザー、マシン、またはフォルダーを表すことができます。 送信されるすべてのメッセージには、名前解決プロセスを経た少なくとも 1 人の受信者が必要です。 これは、PR_ENTRYID (PidTagEntryId) プロパティが受信者のプロパティ値配列に含まれていることを確認するためのプロセスです。
受信者のプロパティは、アドレス帳プロパティとメッセージ プロパティの組み合わせです。 受信者のプロパティは、特定の受信者のすべてのメッセージに適用することも、現在のメッセージにのみ適用することもできます。 メッセージ ストアとトランスポート プロバイダーの両方で、受信者のプロパティを設定できます。
各受信者は、メッセージを送信する準備が整うまでに、プロパティ値配列内のプロパティのコア セットを持っている必要があります。 必要な受信者プロパティのセットは次のとおりです。
PR_ADDRTYPE (PidTagAddressType)
PR_DISPLAY_NAME (PidTagDisplayName)
PR_EMAIL_ADDRESS (PidTagEmailAddress)
PR_ENTRYID
PR_OBJECT_TYPE (PidTagObjectType)
PR_SEARCH_KEY (PidTagSearchKey)
これらのプロパティは、受信者にアクセスしたり、メッセージを送信したり、他のユーザーと比較したりするために使用されます。 これらのプロパティをすべてすぐに使用できる必要はありません。 このプロパティを割り当てる名前解決プロセスに依存して、エントリ識別子を知らなくても、最初に受信者を追加できます。 メッセージを送信する前のある時点で、 IAddrBook::ResolveName を呼び出して、受信者リスト内のすべての受信者が解決されていることを確認します。 詳細については、「 受信者名の解決」を参照してください。
受信者リストは、アドレス帳コンテナー内のメッセージング ユーザーまたは配布リスト エントリから、または 1 回限り作成できます。 1 回限りは、1 つのメッセージのアドレス指定にのみ使用する一時的なエントリとして、または個人用アドレス帳に追加するエントリとして作成される受信者です。 1 回限りのエントリ識別子とアドレスの形式は、MAPI によって定義されます。 これらの形式の詳細については、「 1 回限りのアドレスと 1 回 限りのエントリ識別子」を参照してください。
ユーザーが受信者リストを作成できるようにします。
アドレス帳からのエントリのみを含む。
1 回限りのエントリのみ。
アドレス帳の受信者と 1 回限りの組み合わせ。
共通アドレス ダイアログ ボックスを使用して受信者リストを作成するには
ADRPARM 構造体のメモリをゼロにし、ADRLIST ポインターを NULL に設定します。
IAddrBook::Address を呼び出してアドレス ダイアログ ボックスを表示し、ADRPARM 構造体を設定します。
ADRLIST ポインターを渡して IMessage::ModifyRecipients を呼び出します。 この構造体には、ユーザーによって選択された各受信者のプロパティが含まれます。
プログラムで受信者リストを作成するには
リストに含める各受信者に対して 1 つの ADRENTRY 構造体を含む ADRLIST 構造体を割り当てます。 各 ADRENTRY 構造体を、必要なプロパティと PR_RECIPIENT_TYPE (PidTagRecipientType) を保持するのに十分な大きさにします。
受信者ごとに、ADRLIST 構造体の aEntries メンバーのプロパティ値配列を設定します。
MODRECIP_ADD フラグを設定して IMessage::ModifyRecipients を呼び出します。