HrOpenOfflineObj
Область применения: Outlook 2013 | Outlook 2016
Открывает автономный объект на основе заданного профиля.
Краткие сведения
| Свойство | Значение |
|---|---|
| Экспортировано: |
msmapi32.dll |
| Вызывающая сторона: |
Клиент |
| Реализовано в: |
Outlook |
typedef HRESULT (STDMETHODCALLTYPE HROPENOFFLINEOBJ)(
ULONG ulReserved,
LPCWSTR pwszProfileNameIn,
const GUID* pGUID,
const GUID* pReserved,
IMAPIOfflineMgr** ppOfflineObj);
Параметры
ulReserved
[в] Этот параметр не используется. Должно быть 0.
pwszProfileNameIn
[в] Имя профиля, для которому предназначен автономный объект. Он должен быть выражен в Юникоде.
pGUID
[в] Указатель на GUID, который можно использовать для уникальной идентификации этого объекта из других автономных объектов. Это должно быть GUID_GlobalState.
Сохранились
[в] Этот параметр не используется. Он должен иметь значение NULL.
ppOfflineObj
[out] Указатель на запрошенный автономный объект. Вызывающий объект может использовать этот указатель для доступа к интерфейсу IMAPIOfflineMgr : IMAPIOffline, чтобы найти обратные вызовы, поддерживаемые этим объектом, и настроить обратные вызовы для него.
Возвращаемые значения
S_OK
- Вызов функции выполнен успешно.
MAPI_E_NOT_FOUND
- Сбой вызова функции.
Замечания
Это первый вызов, который выполняет клиент, когда клиент хочет получать уведомления об изменениях состояния подключения для заданного профиля. При вызове HrOpenOfflineObj клиент получает автономный объект, поддерживающий IMAPIOfflineMgr. Клиент может проверка для типов обратных вызовов, поддерживаемых объектом (с помощью IMAPIOffline::GetCapabilities), а затем настроить обратные вызовы для него (с помощью IMAPIOfflineMgr::Advise).
При использовании GetProcAddress для поиска адреса этой функции в msmapi32.dll укажите HrOpenOfflineObj@20 в качестве имени процедуры.
HrOpenOfflineObj работает только для клиентов, которые являются поставщиками MAPI, надстройками COM и расширениями клиента Exchange, работающими в процессе Outlook. В противном случае HrOpenOfflineObj возвращает MAPI_E_NOT_FOUND.