IMsRdpClientNonScriptable::NotifyRedirectDeviceChange メソッド
デバイスの変更がシステムで発生したことをリモート デスクトップ ActiveX コントロールのデバイス リダイレクト モジュールに通知します。 このメソッドは、 WM_DEVICECHANGE 通知をコントロールに渡します。
構文
HRESULT NotifyRedirectDeviceChange(
[in] WPARAM wParam,
[in] LPARAM lParam
);
パラメーター
-
wParam [in]
-
デバイス イベントを指定します。 このパラメーターには、次の値のいずれかを指定できます。
-
DBT_CONFIGCHANGECANCELED
-
現在の構成を変更する要求 (ドックまたはドッキング解除) が取り消されました。
-
DBT_CONFIGCHANGED
-
ドッキングまたはドッキング解除により、現在の構成が変更されました。
-
DBT_CUSTOMEVENT
-
カスタム イベントが発生しました。
-
DBT_DEVICEARRIVAL
-
デバイスが挿入され、使用できるようになりました。
-
DBT_DEVICEQUERYREMOVE
-
デバイスを削除するためのアクセス許可が要求されます。 どのアプリケーションでも、この要求を拒否し、削除を取り消すことができます。
-
DBT_DEVICEQUERYREMOVEFAILED
-
デバイスを削除する要求が取り消されました。
-
DBT_DEVICEREMOVECOMPLETE
-
デバイスが削除されました。
-
DBT_DEVICEREMOVEPENDING
-
デバイスが削除されようとしています。 削除を拒否することはできません。
-
DBT_DEVICETYPESPECIFIC
-
デバイス固有のイベントが発生しました。
-
DBT_DEVNODES_CHANGED
-
デバイスがシステムに追加されたか、システムから削除されました。
-
DBT_QUERYCHANGECONFIG
-
現在の構成を変更するためのアクセス許可が要求されます (ドッキングまたはドッキング解除)。
-
DBT_USERDEFINED
-
このメッセージの意味は、ユーザー定義です。
lParam [in]
イベント固有のデータを含む構造体へのポインター。 その形式は 、wParam パラメーターの値によって異なります。 詳細については、各イベントのドキュメントを参照してください。 詳細については、「 デバイス イベントの種類」を参照してください。
戻り値
成功 した場合はS_OK を返します。
解説
デバイスの動的な追加または削除を許可するコンテナー アプリケーションでは、最上位ウィンドウで WM_DEVICECHANGE メッセージを処理し、 NotifyRedirectDeviceChange メソッドを使用してメッセージをコントロールに転送する必要があります。 動的なデバイス変更の例として、システムの実行中にリダイレクトされたディスク ドライブが追加または削除される場合があります。
リモート デスクトップ Web 接続の詳細については、「リモート デスクトップ Web 接続 の要件」を参照してください。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| タイプ ライブラリ |
|
| [DLL] |
|
| IID |
IID_IMsRdpClientNonScriptableは 2f079c4c-87b2-4afd-97ab-20cdb43038ae として定義されています |