Vorbereiten eines Empfängers

Gilt für: Outlook 2013 | Outlook 2016

Eine Clientanwendung bereitet Empfänger vor, indem sie ihre bezeichner für kurzfristige Eingaben in langfristige Eingabebezeichner konvertiert und möglicherweise Eigenschaften hinzufügt, ändert oder neu anordnet. Sie können Empfänger, die Teil einer Empfängerliste sind, für eine Nachricht oder Empfänger vorbereiten, die nicht mit einer Nachricht verknüpft sind. In der Regel rufen Clients IAddrBook::P repareRecips direkt auf, um kurzfristige Eingabebezeichner in langfristige Eingabebezeichner für Empfänger zu übersetzen, die im Dialogfeld "Allgemeine Adresse" enthalten sind. Für Empfänger, die einer ausgehenden Nachricht zugeordnet sind, wird die Empfängervorbereitung durch den Namensauflösungsprozess verarbeitet.

Rufen Sie zum Vorbereiten einer Empfängerliste IAddrBook::P repareRecips auf. PrepareRecips akzeptiert eine ADRLIST-Struktur und eine Liste von Eigenschaftstags. Die ADRLIST-Struktur enthält die Empfänger, die vorbereitet werden sollen, während die Liste der Eigenschaftentags Eigenschaften darstellt, die jeder Empfänger unterstützen sollte. PrepareRecips versucht, die Eigenschaften, die in der Eigenschaftentagliste enthalten sind, am Anfang der ADRLIST-Struktur zu platzieren. Wenn eine der Eigenschaften in der Liste in der ADRLIST-Struktur fehlt, ruft MAPI den Adressbuchanbieter auf, um sie anzugeben. Wenn Sie nur nach Langzeiteintragsbezeichnern suchen müssen, übergeben Sie NULL für den lpSPropTagArray-Parameter .

Angenommen, Sie arbeiten mit fünf Empfängern. Alle fünf Empfänger werden in der ADRLIST-Struktur mit den folgenden Eigenschaften in der folgenden Reihenfolge angezeigt:

1. PR_ENTRYID (PidTagEntryId)

2. PR_DISPLAY_NAME (PidTagDisplayName)

3. PR_SEARCH_KEY (PidTagSearchKey)

4. PR_EMAIL_ADDRESS (PidTagEmailAddress)

5. PR_ADDRTYPE (PidTagAddressType)

Drei weitere Eigenschaften sind in der ADRLIST-Struktur für die ersten beiden Empfänger enthalten.

1. PR_ACCOUNT (PidTagAccount)

2. PR_GIVEN_NAME (PidTagGivenName)

3. PR_SURNAME (PidTagSurname)

Da alle Empfänger über die ersten drei Eigenschaften PR_ADDRTYPE, PR_ENTRYID und PR_HOME_TELEPHONE_NUMBER (PidTagHomeTelephoneNumber) verfügen müssen, erstellen Sie ein Eigenschaftentagarray mit diesen Eigenschaften, und übergeben Sie es und die ADRLIST-Struktur an PrepareRecips. PrepareRecips ruft die IMAPIProp::GetProps-Methode jedes Empfängers auf, um PR_HOME_TELEPHONE_NUMBER abzurufen, da sie derzeit nicht Teil der ADRLIST-Struktur ist. Wenn PrepareRecips zurückgibt, stellt die Empfängerliste eine zusammengeführte Liste von Empfängern dar, deren Eigenschaften in der ADRLIST-Struktur zuerst für jeden Empfänger angezeigt werden.

Die Empfängerliste für die Empfänger 1 und 2 enthält eigenschaften in der folgenden Reihenfolge:

1. PR_ADDRTYPE

2. PR_ENTRYID

3. PR_HOME_TELEPHONE_NUMBER

4. PR_DISPLAY_NAME

5. PR_SEARCH_KEY

6. PR_EMAIL_ADDRESS

7. PR_ADDRTYPE

8. PR_ACCOUNT

9. PR_GIVEN_NAME

10. PR_SURNAME

Die Empfängerliste für die Empfänger 3, 4 und 5 enthält Eigenschaften in der folgenden Reihenfolge:

1. PR_ADDRTYPE

2. PR_ENTRYID

3. PR_HOME_TELEPHONE_NUMBER

4. PR_DISPLAY_NAME

5. PR_SEARCH_KEY

6. PR_EMAIL_ADDRESS

7. PR_ADDRTYPE

Als Alternative zum Aufrufen von IAddrBook::P repareRecips zum Arbeiten mit Eigenschaften rufen Sie die IMAPIProp::GetProps-Methode jedes Empfängers und ggf. seine IMAPIProp::SetProps-Methode auf. Wenn nur ein Empfänger beteiligt ist, ist beide Technik zufriedenstellend. Wenn jedoch mehrere Empfänger beteiligt sind, spart das Aufrufen von PrepareRecips anstelle der IMAPIProp-Methoden Zeit und, wenn Sie remote arbeiten, viele Remoteprozeduraufrufe. PrepareRecips verarbeitet alle Empfänger in einem einzigen Aufruf, während GetProps und SetProps einen Aufruf für jeden Empfänger ausführen.