IMAPIOfflineMgr::Advise
適用対象: Outlook 2013 | Outlook 2016
オフライン オブジェクトでコールバックを受信するクライアントを登録します。
HRESULT COfflineObj::Advise(
ULONG ulFlags,
MAPIOFFLINE_ADVISEINFO* pAdviseInfo,
ULONG* pulAdviseToken
);
パラメーター
ulFlags
[in]動作を変更するフラグ。 MAPIOFFLINE_ADVISE_DEFAULT値のみがサポートされています。
pAdviseInfo
[in]コールバックの種類、コールバックを受信するタイミング、呼び出し元のコールバック インターフェイス、その他の詳細に関する情報。 また、Outlook が後続の通知コールバックをクライアント呼び出し元に送信するときに使用するクライアント トークンも含まれています。
pulAdviseToken
[out]その後オブジェクトのコールバックを取り消すために、クライアント呼び出し元に返されたアドバイス トークン。
戻り値
S_OK
呼び出しが正常になされました。
E_INVALIDARG
無効なパラメーターが指定されました。
E_NOINTERFACE
pAdviseInfo で指定されたコールバック インターフェイスが無効です。
注釈
HrOpenOfflineObj を使用してオフライン オブジェクトを開くと、クライアントは IMAPIOfflineMgr をサポートするオフライン オブジェクトを取得します。 クライアントは、IMAPIOffline::GetCapabilities を使用して、オブジェクトでサポートされるコールバックの種類をチェックできます。 クライアントは、必要なコールバックに関する型やその他の詳細を決定し、 IMAPIOfflineMgr::Advise を呼び出して登録し、オブジェクトに関するそのようなコールバックを受け取ることができます。