Freigeben über

Erstellen einer Empfängerliste

Gilt für: Outlook 2013 | Outlook 2016

Eine Empfängerliste ist eine ADRLIST-Struktur , die ein Array von Eigenschaftenwertstrukturen für jeden Nachrichtenempfänger – Ziel für die Nachricht – enthält. Ein Empfänger kann einen menschlichen Benutzer, einen Computer oder einen Ordner darstellen. Alle zu sendenden Nachrichten erfordern mindestens einen Empfänger, der den Namensauflösungsprozess durchlaufen hat– ein Prozess, mit dem sichergestellt wird, dass die Eigenschaft PR_ENTRYID (PidTagEntryId) im Eigenschaftenwertarray des Empfängers enthalten ist.

Die Eigenschaften eines Empfängers sind eine Kombination aus Adressbucheigenschaften und Nachrichteneigenschaften. Empfängereigenschaften können entweder auf alle Nachrichten für einen bestimmten Empfänger oder nur auf die aktuelle Nachricht angewendet werden. Sowohl Nachrichtenspeicher- als auch Transportanbieter können Empfängereigenschaften festlegen.

Jeder Empfänger muss über einen Kernsatz von Eigenschaften in seinem Eigenschaftenwertarray verfügen, wenn die Nachricht zum Senden bereit ist. Zu den erforderlichen Empfängereigenschaften gehören:

Diese Eigenschaften werden verwendet, um auf den Empfänger zuzugreifen, Nachrichten an ihn zu senden und ihn mit anderen zu vergleichen. Nicht alle diese Eigenschaften müssen sofort verfügbar sein. Sie können einen Empfänger zunächst hinzufügen, ohne seinen Eintragsbezeichner zu kennen, und sich dabei auf den Namensauflösungsprozess verlassen, um diese Eigenschaft zuzuweisen. Rufen Sie vor dem Senden einer Nachricht IAddrBook::ResolveName auf, um sicherzustellen, dass alle Empfänger in Ihrer Empfängerliste aufgelöst sind. Weitere Informationen finden Sie unter Auflösen eines Empfängernamens.

Empfängerlisten können aus Nachrichtenbenutzern oder Verteilerlisteneinträgen in einem Adressbuchcontainer oder aus Einmaligen erstellt werden. Einmalige Empfänger sind Empfänger, die entweder als temporäre Einträge erstellt werden, die nur für die Adressierung einer einzelnen Nachricht verwendet werden sollen, oder als Einträge, die einem persönlichen Adressbuch hinzugefügt werden sollen. Das Format für einen einmaligen Eintragsbezeichner und die Adresse wird von MAPI definiert. Weitere Informationen zu diesen Formaten finden Sie unter Einmalige Adressen und Bezeichner für einmalige Einträge.

Sie können Benutzern das Erstellen ihrer Empfängerlisten ermöglichen:

  • Nur mit Einträgen aus dem Adressbuch.

  • Nur mit einmaligen Einträgen.

  • Mit einer Kombination aus Adressbuchempfängern und Einmaligen.

So erstellen Sie eine Empfängerliste mithilfe des Dialogfelds "Allgemeine Adresse"

  1. Weisen Sie eine ADRPARM-Struktur und einen Zeiger auf eine ADRLIST-Struktur zu.

  2. Null des Arbeitsspeichers in der ADRPARM-Struktur , und legen Sie den ADRLIST-Zeiger auf NULL fest.

  3. Rufen Sie IAddrBook::Address auf, um das Adressdialogfeld anzuzeigen und die ADRPARM-Struktur aufzufüllen.

  4. Rufen Sie IMessage::ModifyRecipients auf, und übergeben Sie den ADRLIST-Zeiger . Diese Struktur enthält die Eigenschaften der einzelnen empfänger, die vom Benutzer ausgewählt wurden.

So erstellen Sie programmgesteuert eine Empfängerliste

  1. Ordnen Sie eine ADRLIST-Struktur zu, die eine ADRENTRY-Struktur für jeden empfänger enthält, der in die Liste aufgenommen werden soll. Legen Sie jede ADRENTRY-Struktur so groß fest, dass jede der erforderlichen Eigenschaften und PR_RECIPIENT_TYPE (PidTagRecipientType) enthalten ist.

  2. Legen Sie für jeden Empfänger das Eigenschaftswertarray für den zugehörigen aEntries-Member in der ADRLIST-Struktur fest.

  3. Rufen Sie IMessage::ModifyRecipients mit festgelegtem MODRECIP_ADD-Flag auf.