IHWEventHandler2::HandleEventWithHWND メソッド (shobjidl.h)

アプリケーションが処理するために登録されていないコンテンツ タイプを含む自動再生デバイス イベントを処理します。 このメソッドは、プロセスに昇格された特権が必要な場合に UI を表示できるように、所有者ウィンドウへのハンドルを提供します。

構文

HRESULT HandleEventWithHWND(
  [in] LPCWSTR pszDeviceID,
  [in] LPCWSTR pszAltDeviceID,
  [in] LPCWSTR pszEventType,
  [in] HWND    hwndOwner
);

パラメーター

[in] pszDeviceID

種類: LPCWSTR

デバイス ID を含む文字列バッファーへのポインター。

[in] pszAltDeviceID

種類: LPCWSTR

代替デバイス ID を含む文字列バッファーへのポインター。 代替デバイス ID は、プライマリ デバイス ID よりも人間が判読できます。

[in] pszEventType

種類: LPCWSTR

イベントの種類を含む文字列バッファーへのポインター。 イベントの種類には、DeviceArrival、DeviceRemoval、MediaArrival、MediaRemoval が含まれます。

[in] hwndOwner

型: HWND

表示された [自動再生] ダイアログへのハンドル。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

ハンドラーが呼び出され、新しいプロセスで即時の特権昇格が必要な場合、その同意 UI を表示するにはアクティブな親ウィンドウ ハンドルが必要です。 IHWEventHandler::HandleEvent ではハンドルを指定できないため、点滅するタスク バーのみが表示されます。 IHWEventHandler2::HandleEventWithHWND は HWND を提供し、UI を表示できるようにします。

ハンドラーが直接ユーザー アクションではなく既定で起動された場合、HWND はアクティブではなく、ダイアログはフォアグラウンドに表示されないことに注意してください。

イベントの種類は C/C++ 言語定数ではありません。これらはリテラル テキスト文字列です。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl.h