IMAPISupport::OpenAddressBook
Hace referencia a: Outlook 2013 | Outlook 2016
Proporciona acceso a la libreta de direcciones.
HRESULT OpenAddressBook(
LPCIID lpInterface,
ULONG ulFlags,
LPADRBOOK FAR * lppAdrBook
);
Parameters
lpInterface
[in] Puntero al identificador de interfaz (IID) que representa la interfaz que se va a usar para acceder a la libreta de direcciones. Los valores válidos son NULL, que indica la interfaz de la libreta de direcciones estándar IAddrBook y IID_IAddrBook.
ulFlags
Reservados; debe ser cero.
lppAdrBook
[out] Puntero a un puntero a la libreta de direcciones.
Valor devuelto
S_OK
Se proporcionó acceso a la libreta de direcciones.
MAPI_W_ERRORS_RETURNED
La llamada se realizó correctamente, pero no se pudo cargar uno o varios proveedores de libreta de direcciones. Cuando se devuelve esta advertencia, la llamada debe controlarse correctamente. Para probar esta advertencia, use la macro HR_FAILED . Para obtener más información, vea Uso de macros para el control de errores.
Comentarios
El método IMAPISupport::OpenAddressBook se implementa para todos los objetos de soporte técnico del proveedor de servicios. Los proveedores de servicios, normalmente proveedores de transporte y almacén de mensajes estrechamente acoplados, llaman a OpenAddressBook para obtener acceso a la libreta de direcciones. El puntero IAddrBook devuelto se puede usar para una variedad de tareas de libreta de direcciones, como abrir contenedores de libreta de direcciones, buscar usuarios de mensajería y mostrar cuadros de diálogo de direcciones.
Notas para los llamadores
OpenAddressBook puede devolver MAPI_W_ERRORS_RETURNED si no puede cargar uno o varios proveedores de libreta de direcciones en el perfil actual. Este valor es una advertencia y debe tratar la llamada como correcta. Incluso si no se pudieron cargar todos los proveedores de libreta de direcciones, OpenAddressBook sigue funcionando correctamente, devolviendo MAPI_W_ERRORS_RETURNED y un puntero IAddrBook en el parámetro lppAdrBook . Dado que OpenAddressBook siempre devuelve un puntero IAddrBook válido, debe liberarlo cuando haya terminado de usarlo.
Si uno o varios proveedores de libreta de direcciones no se pudieron cargar, llame a IMAPISupport::GetLastError para obtener una estructura MAPIERROR que contenga información sobre los proveedores que no se cargaron.