IPortableDeviceService::Advise メソッド (portabledeviceapi.h)

  • [アーティクル]

Advise メソッドは、サービス イベントを受信するアプリケーション定義のコールバック オブジェクトを登録します。

構文

HRESULT Advise(
  [in]  const DWORD                  dwFlags,
  [in]  IPortableDeviceEventCallback *pCallback,
  [in]  IPortableDeviceValues        *pParameters,
  [out] LPWSTR                       *ppszCookie
);

パラメーター

[in] dwFlags

使用しません。

[in] pCallback

登録するコールバック オブジェクトを指定する IPortableDeviceEventCallback インターフェイス。

[in] pParameters

イベント登録パラメーターを指定する IPortableDeviceValues インターフェイス。コールバック オブジェクトがすべてのサービス イベントを受信する場合は NULL 。

[out] ppszCookie

コールバック オブジェクトの一意のコンテキスト ID。 この値は、コールバック オブジェクトの登録を解除するために Unadvise メソッドによって使用される値と一致します。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
E_POINTER
 pCallback パラメーターまたは ppszCookie パラメーターに NULL 値が指定されました。

注釈

クリーンアップ中に、アプリケーションは Unadvise メソッドを呼び出してコールバック オブジェクトの登録を解除し、CoTaskMemFree 関数を呼び出して ppszCookie パラメーターによって参照されるメモリを解放する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー portabledeviceapi.h

こちらもご覧ください

IPortableDeviceService インターフェイス