HrOpenOfflineObj
Hace referencia a: Outlook 2013 | Outlook 2016
Abre un objeto sin conexión basado en un perfil determinado.
Información rápida
| Propiedad | Valor |
|---|---|
| Exportado por: |
msmapi32.dll |
| Llamado por: |
Cliente |
| Implementado por: |
Outlook |
typedef HRESULT (STDMETHODCALLTYPE HROPENOFFLINEOBJ)(
ULONG ulReserved,
LPCWSTR pwszProfileNameIn,
const GUID* pGUID,
const GUID* pReserved,
IMAPIOfflineMgr** ppOfflineObj);
Parameters
ulReserved
[in] No se usa este parámetro. Debe ser 0.
pwszProfileNameIn
[in] Nombre del perfil para el que está el objeto sin conexión. Debe expresarse en Unicode.
pGUID
[in] Puntero a un GUID que se puede usar para identificar de forma única este objeto de otros objetos sin conexión. Debe ser GUID_GlobalState.
Conservado
[in] No se usa este parámetro. Debe ser null.
ppOfflineObj
[out] Puntero al objeto sin conexión solicitado. El llamador puede usar este puntero para acceder a la interfaz IMAPIOfflineMgr : IMAPIOffline para buscar las devoluciones de llamada que admite este objeto y configurar las devoluciones de llamada para él.
Valores devueltos
S_OK
- La llamada a la función se realiza correctamente.
MAPI_E_NOT_FOUND
- Error en la llamada a la función.
Comentarios
Esta es la primera llamada que realiza un cliente cuando el cliente quiere recibir una notificación de los cambios de estado de conexión de un perfil determinado. Al llamar a HrOpenOfflineObj, el cliente obtiene un objeto sin conexión que admite IMAPIOfflineMgr. El cliente puede comprobar los tipos de devoluciones de llamada compatibles con el objeto (mediante IMAPIOffline::GetCapabilities) y, a continuación, configurar las devoluciones de llamada para él (mediante IMAPIOfflineMgr::Advise).
Al usar GetProcAddress para buscar la dirección de esta función en msmapi32.dll, especifique HrOpenOfflineObj@20 como nombre del procedimiento.
HrOpenOfflineObj solo funciona para los clientes que son proveedores MAPI, complementos COM y extensiones de cliente de Exchange que se ejecutan dentro del proceso de Outlook. De lo contrario, HrOpenOfflineObj devuelve MAPI_E_NOT_FOUND.
Vea también
IMAPIOfflineMgr : IMAPIOffline