IMAPISupport::OpenAddressBook
Gilt für: Outlook 2013 | Outlook 2016
Bietet Zugriff auf das Adressbuch.
HRESULT OpenAddressBook(
LPCIID lpInterface,
ULONG ulFlags,
LPADRBOOK FAR * lppAdrBook
);
Parameter
lpInterface
[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID), der die Schnittstelle darstellt, die für den Zugriff auf das Adressbuch verwendet werden soll. Gültige Werte sind NULL, was die Standardadressbuchschnittstelle IAddrBook angibt, und IID_IAddrBook.
ulFlags
Reserviert; muss null sein.
lppAdrBook
[out] Ein Zeiger auf einen Zeiger auf das Adressbuch.
Rückgabewert
S_OK
Zugriff auf das Adressbuch wurde bereitgestellt.
MAPI_W_ERRORS_RETURNED
Der Aufruf war erfolgreich, aber mindestens ein Adressbuchanbieter konnte nicht geladen werden. Wenn diese Warnung zurückgegeben wird, sollte der Aufruf als erfolgreich behandelt werden. Verwenden Sie zum Testen auf diese Warnung das Makro HR_FAILED . Weitere Informationen finden Sie unter Verwenden von Makros für die Fehlerbehandlung.
Hinweise
Die IMAPISupport::OpenAddressBook-Methode wird für alle Dienstanbieterunterstützungsobjekte implementiert. Dienstanbieter, in der Regel eng gekoppelte Nachrichtenspeicher- und Transportanbieter, rufen OpenAddressBook auf, um Zugriff auf das Adressbuch zu erhalten. Der zurückgegebene IAddrBook-Zeiger kann für eine Vielzahl von Adressbuchaufgaben verwendet werden, darunter das Öffnen von Adressbuchcontainern, das Suchen von Messagingbenutzern und das Anzeigen von Adressdialogfeldern.
Hinweise für Aufrufer
OpenAddressBook kann MAPI_W_ERRORS_RETURNED zurückgeben, wenn ein oder mehrere Adressbuchanbieter im aktuellen Profil nicht geladen werden können. Dieser Wert ist eine Warnung, und Sie sollten den Aufruf als erfolgreich behandeln. Auch wenn alle Adressbuchanbieter nicht geladen werden konnten, ist OpenAddressBook weiterhin erfolgreich und gibt MAPI_W_ERRORS_RETURNED und einen IAddrBook-Zeiger im lppAdrBook-Parameter zurück. Da OpenAddressBook immer einen gültigen IAddrBook-Zeiger zurückgibt, müssen Sie ihn freigeben, wenn Sie ihn nicht mehr verwenden.
Wenn ein oder mehrere Adressbuchanbieter nicht geladen werden konnten, rufen Sie IMAPISupport::GetLastError auf, um eine MAPIERROR-Struktur abzurufen, die Informationen zu den Anbietern enthält, die nicht geladen wurden.