IMAPISupport::OpenAddressBook
S’applique à : Outlook 2013 | Outlook 2016
Fournit l’accès au carnet d’adresses.
HRESULT OpenAddressBook(
LPCIID lpInterface,
ULONG ulFlags,
LPADRBOOK FAR * lppAdrBook
);
Paramètres
lpInterface
[in] Pointeur vers l’identificateur d’interface (IID) qui représente l’interface à utiliser pour accéder au carnet d’adresses. Les valeurs valides sont NULL, ce qui indique l’interface de carnet d’adresses standard IAddrBook et IID_IAddrBook.
ulFlags
Réservés au; doit être égal à zéro.
lppAdrBook
[out] Pointeur vers un pointeur vers le carnet d’adresses.
Valeur renvoyée
S_OK
L’accès au carnet d’adresses a été fourni.
MAPI_W_ERRORS_RETURNED
L’appel a réussi, mais un ou plusieurs fournisseurs de carnets d’adresses n’ont pas pu être chargés. Lorsque cet avertissement est retourné, l’appel doit être géré comme ayant réussi. Pour tester cet avertissement, utilisez la macro HR_FAILED . Pour plus d’informations, consultez Utilisation de macros pour la gestion des erreurs.
Remarques
La méthode IMAPISupport ::OpenAddressBook est implémentée pour tous les objets de prise en charge du fournisseur de services. Les fournisseurs de services, généralement étroitement couplés de magasins de messages et de fournisseurs de transport, appellent OpenAddressBook pour accéder au carnet d’adresses. Le pointeur IAddrBook retourné peut être utilisé pour diverses tâches de carnet d’adresses, notamment l’ouverture de conteneurs de carnets d’adresses, la recherche d’utilisateurs de messagerie et l’affichage des boîtes de dialogue d’adresse.
Remarques pour les appelants
OpenAddressBook peut retourner MAPI_W_ERRORS_RETURNED s’il ne peut pas charger un ou plusieurs fournisseurs de carnets d’adresses dans le profil actuel. Cette valeur est un avertissement et vous devez traiter l’appel comme réussi. Même si tous les fournisseurs de carnets d’adresses n’ont pas pu être chargés, OpenAddressBook réussit toujours, renvoyant MAPI_W_ERRORS_RETURNED et un pointeur IAddrBook dans le paramètre lppAdrBook . Étant donné qu’OpenAddressBook retourne toujours un pointeur IAddrBook valide, vous devez le libérer lorsque vous avez terminé de l’utiliser.
Si un ou plusieurs fournisseurs de carnets d’adresses n’ont pas pu se charger, appelez IMAPISupport ::GetLastError pour obtenir une structure MAPIERROR qui contient des informations sur les fournisseurs qui n’ont pas été chargés.