IAddrBook::PrepareRecips
Gilt für: Outlook 2013 | Outlook 2016
Bereitet eine Empfängerliste für die spätere Verwendung durch das Messagingsystem vor.
HRESULT PrepareRecips(
ULONG ulFlags,
LPSPropTagArray lpSPropTagArray,
LPADRLIST lpRecipList
);
Parameter
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie der Eintrag geöffnet wird. Das folgende Flag kann festgelegt werden:
MAPI_CACHE_ONLY
Verwenden Sie nur das Offlineadressbuch, um die Namensauflösung durchzuführen. Sie können dieses Flag beispielsweise verwenden, um einer Clientanwendung das Öffnen der globalen Adressliste (GAL) im zwischengespeicherten Austauschmodus und den Zugriff auf einen Eintrag in diesem Adressbuch aus dem Cache zu ermöglichen, ohne Datenverkehr zwischen Client und Server zu erzeugen. Dieses Flag wird nur vom Exchange-Adressbuchanbieter unterstützt.
lpSPropTagArray
[in] Ein Zeiger auf eine SPropTagArray-Struktur , die ein Array von Eigenschaftstags enthält, die ggf. die Eigenschaften angeben, die aktualisiert werden müssen. Der lpSPropTagArray-Parameter kann NULL sein.
lpRecipList
[in] Ein Zeiger auf eine ADRLIST-Struktur , die die Liste der Empfänger enthält.
Rückgabewert
S_OK
Die Empfängerliste wurde erfolgreich vorbereitet.
Hinweise
Clients und Dienstanbieter rufen die PrepareRecips-Methode auf, um folgende Aktionen auszuführen:
Stellen Sie sicher, dass alle Empfänger im lpRecipList-Parameter über langfristige Eingabebezeichner verfügen.
Stellen Sie sicher, dass jeder Empfänger im lpRecipList-Parameter über die eigenschaften verfügt, die im lpSPropTagArray-Parameter aufgeführt sind und dass diese Eigenschaften am Anfang der Empfängerliste angezeigt werden.
MAPI konvertiert die Bezeichner der kurzfristigen Eingaben jedes Empfängers in langfristige Eingabebezeichner. Bei Bedarf werden die Langzeiteintragsbezeichner der Empfänger vom entsprechenden Adressbuchanbieter abgerufen und alle zusätzlichen Eigenschaften angefordert.
In einem einzelnen Empfängereintrag werden die angeforderten Eigenschaften zuerst sortiert, gefolgt von allen Eigenschaften, die bereits für den Eintrag vorhanden waren. Wenn eine oder mehrere der angeforderten Eigenschaften im lpSPropTagArray-Parameter nicht vom entsprechenden Adressbuchanbieter verarbeitet werden, werden ihre Eigenschaftentypen auf PT_ERROR festgelegt. Ihre Eigenschaftswerte werden entweder auf MAPI_E_NOT_FOUND oder auf einen anderen Wert festgelegt, der einen genaueren Grund dafür angibt, warum die Eigenschaften nicht verfügbar sind. Jede SPropValue-Struktur , die im lpRecipList-Parameter enthalten ist, muss separat mithilfe der Funktionen MAPIAllocateBuffer und MAPIAllocateMore zugeordnet werden, damit sie einzeln freigegeben werden kann.
Informationen zu PT_ERROR finden Sie unter Eigenschaftentypen.