IMsRdpClientNonScriptable::NotifyRedirectDeviceChange-Methode
Benachrichtigt das Modul zur Geräteumleitung des ActiveX-Remotedesktops, dass eine Geräteänderung auf dem System aufgetreten ist. Diese Methode übergibt WM_DEVICECHANGE Benachrichtigungen an das Steuerelement.
Syntax
HRESULT NotifyRedirectDeviceChange(
[in] WPARAM wParam,
[in] LPARAM lParam
);
Parameter
-
wParam [in]
-
Gibt das Geräteereignis an. Dieser Parameter kann einen der folgenden Werte annehmen.
-
DBT_CONFIGCHANGECANCELED
-
Eine Anforderung zum Ändern der aktuellen Konfiguration (Dock oder Abdocken) wurde abgebrochen.
-
DBT_CONFIGCHANGED
-
Die aktuelle Konfiguration hat sich aufgrund eines Docks oder Abkoppelns geändert.
-
DBT_CUSTOMEVENT
-
Ein benutzerdefiniertes Ereignis ist aufgetreten.
-
DBT_DEVICEARRIVAL
-
Ein Gerät wurde eingefügt und ist jetzt verfügbar.
-
DBT_DEVICEQUERYREMOVE
-
Zum Entfernen eines Geräts wird die Berechtigung angefordert. Jede Anwendung kann diese Anforderung ablehnen und die Entfernung abbrechen.
-
DBT_DEVICEQUERYREMOVEFAILED
-
Eine Anforderung zum Entfernen eines Geräts wurde abgebrochen.
-
DBT_DEVICEREMOVECOMPLETE
-
Ein Gerät wurde entfernt.
-
DBT_DEVICEREMOVEPENDING
-
Ein Gerät wird entfernt. Die Entfernung kann nicht verweigert werden.
-
DBT_DEVICETYPESPECIFIC
-
Es ist ein gerätespezifisches Ereignis aufgetreten.
-
DBT_DEVNODES_CHANGED
-
Ein Gerät wurde dem System hinzugefügt oder aus diesem entfernt.
-
DBT_QUERYCHANGECONFIG
-
Zum Ändern der aktuellen Konfiguration (Dock oder Abdocken) wird eine Berechtigung angefordert.
-
DBT_USERDEFINED
-
Die Bedeutung dieser Nachricht ist benutzerdefinierte.
lParam [in]
Zeiger auf eine Struktur, die ereignisspezifische Daten enthält. Sein Format hängt vom Wert des wParam-Parameters ab. Weitere Informationen finden Sie in der Dokumentation zu den einzelnen Ereignissen. Weitere Informationen finden Sie unter Geräteereignistypen.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück.
Bemerkungen
Eine Containeranwendung, die das dynamische Hinzufügen oder Entfernen von Geräten ermöglicht, sollte die WM_DEVICECHANGE Nachricht im Fenster der obersten Ebene verarbeiten und die Nachricht mithilfe der NotifyRedirectDeviceChange-Methode an das Steuerelement weiterleiten. Ein Beispiel für eine dynamische Geräteänderung ist, wenn ein umgeleitetes Datenträgerlaufwerk hinzugefügt oder entfernt wird, während das System ausgeführt wird.
Weitere Informationen zur Remotedesktop-Webverbindung finden Sie unter Anforderungen für die Remotedesktopwebverbindung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Typbibliothek |
|
| DLL |
|
| IID |
IID_IMsRdpClientNonScriptable ist definiert als 2f079c4c-87b2-4afd-97ab-20cdb43038ae |