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
[in]このパラメーターは使用されません。 0 にする必要があります。
pwszProfileNameIn
[in]オフライン オブジェクトの対象となるプロファイルの名前。 Unicode で表す必要があります。
pGUID
[in]他のオフライン オブジェクトからこのオブジェクトを一意に識別するために使用できる GUID へのポインター。 GUID_GlobalStateする必要があります。
保存
[in]このパラメーターは使用されません。 null にする必要があります。
ppOfflineObj
[out]要求されたオフライン オブジェクトへのポインター。 呼び出し元は、このポインターを使用して IMAPIOfflineMgr : IMAPIOffline インターフェイスにアクセスして、このオブジェクトがサポートするコールバックを見つけ、コールバックを設定できます。
戻り値
S_OK
- 関数呼び出しが成功しました。
MAPI_E_NOT_FOUND
- 関数呼び出しに失敗しました。
注釈
これは、クライアントが特定のプロファイルの接続状態の変更を通知する場合に、クライアントが行う最初の呼び出しです。 HrOpenOfflineObj を呼び出すと、クライアントは IMAPIOfflineMgr をサポートするオフライン オブジェクトを取得します。 クライアントは、オブジェクトでサポートされているコールバックの種類 (IMAPIOffline::GetCapabilities を使用) に対してチェックし、(IMAPIOfflineMgr::Advise を使用して) コールバックを設定できます。
GetProcAddress を使用して msmapi32.dll でこの関数のアドレスを検索する場合は、プロシージャ名として HrOpenOfflineObj@20 を指定します。
HrOpenOfflineObj は、Outlook プロセス内で実行されている MAPI プロバイダー、COM アドイン、および Exchange クライアント拡張機能であるクライアントに対してのみ機能します。 それ以外の場合、 HrOpenOfflineObj は MAPI_E_NOT_FOUNDを返します。