Empfängertabellen
Gilt für: Outlook 2013 | Outlook 2016
Die Empfängertabelle enthält Informationen zu allen Empfängern für eine Nachricht. Nachrichtenspeicheranbieter implementieren Empfängertabellen, und Clientanwendungen verwenden sie. Clients greifen auf eine Empfängertabelle zu, indem sie die IMessage::GetRecipientTable-Methode aufrufen oder, wenn der Nachrichtenspeicheranbieter dies unterstützt, an die IMAPIProp::OpenProperty-Methode . Clients greifen mit OpenProperty auf Empfängertabellen zu, indem sie PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) für das Eigenschaftentag und IID_IMAPITable für den Schnittstellenbezeichner angeben. Änderungen an einer Empfängertabelle können durch Aufrufen der IMessage::ModifyRecipients-Methode vorgenommen werden.
Empfängertabellen weisen einen anderen Spaltensatz auf, je nachdem, ob die Nachricht gesendet wurde. Die folgenden Eigenschaften bilden den erforderlichen Spaltensatz in Empfängertabellen:
PR_DISPLAY_NAME (PidTagDisplayName)
PR_RECIPIENT_TYPE (PidTagRecipientType)
PR_ROWID (PidTagRowid)
Die optionalen Eigenschaften sind:
PR_DISPLAY_TYPE (PidTagDisplayType)
PR_ENTRYID (PidTagEntryId)
PR_SPOOLER_STATUS (PidTagSpoolerStatus)
PR_OBJECT_TYPE (PidTagObjectType)
Übermittelte Nachrichten sollten diese zusätzlichen Eigenschaften in ihrem erforderlichen Spaltensatz enthalten:
PR_ADDRTYPE (PidTagAddressType)
PR_RESPONSIBILITY (PidTagResponsibility)
Abhängig von der Implementierung eines Anbieters können zusätzliche Spalten, z. B. PR_SENDER_NAME (PidTagSenderName) und ENTRYID, in der Tabelle enthalten sein.
Jeder Nachrichtenspeicheranbieter, der die Nachrichtenübertragung unterstützt – wie durch das in der PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask)-Eigenschaft des Anbieters festgelegte STORE_SUBMIT_OK Bit angegeben – sollte Unterstützung für einen bestimmten Satz von Einschränkungen in einer Empfängertabellenimplementierung bieten. Die Einschränkungen AND, OR und Eigenschaften gehören zu den Arten von Einschränkungen, die benutzern der Empfängertabelle zur Verfügung stehen sollten. Nur die Gleichheitsoperatoren und nicht gleich-Operatoren müssen für die Eigenschaftseinschränkung unterstützt werden. Diese Einschränkungen müssen mit den folgenden Eigenschaften funktionieren:
PR_ADDRTYPE
PR_EMAIL_ADDRESS (PidTagEmailAddress)
PR_RECIPIENT_TYPE
PR_RESPONSIBILITY
PR_SPOOLER_STATUS