IMsRdpClientNonScriptable::NotifyRedirectDeviceChange-Methode
Benachrichtigt das Geräteumleitungsmodul des Remotedesktop ActiveX, 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 wurde aufgrund eines Andocks oder Abdockens geändert.
-
DBT _ CUSTOMEVENT
-
Ein benutzerdefiniertes Ereignis ist aufgetreten.
-
DBT _ DEVICEARRARRARR
-
Ein Gerät wurde eingefügt und ist jetzt verfügbar.
-
DBT _ DEVICEQUERYREMOVE
-
Die Berechtigung zum Entfernen eines Geräts wird angefordert. Jede Anwendung kann diese Anforderung verweigern 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. Das Entfernen kann nicht verweigert werden.
-
DBT _ DEVICETYPESPECIFIC
-
Ein gerätespezifisches Ereignis ist aufgetreten.
-
DBT _ DEVNODES _ GEÄNDERT
-
Ein Gerät wurde dem System hinzugefügt oder daraus entfernt.
-
DBT _ QUERYCHANGECONFIG
-
Die Berechtigung zum Ändern der aktuellen Konfiguration (Dock oder Abdocken) wird angefordert.
-
DBT _ USERDEFINED
-
Die Bedeutung dieser Nachricht ist benutzerdefiniert.
lParam [ In]
Zeiger auf eine -Struktur, die ereignisspezifische Daten enthält. Das Format hängt vom Wert des wParam-Parameters ab. Weitere Informationen finden Sie in der Dokumentation zu jedem Ereignis. Weitere Informationen finden Sie unter Geräteereignistypen.
Rückgabewert
Geben Sie S _ OK zurück, wenn erfolgreich.
Hinweise
Eine Containeranwendung, die das dynamische Addition oder Entfernen von Geräten zulässt, 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 Laufwerk hinzugefügt oder entfernt wird, während das System ausgeführt wird.
Weitere Informationen zu Remotedesktop-Webverbindung finden Sie unter Anforderungen für Remotedesktop-Webverbindung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ IMsRdpClientNonScriptable ist als 2f079c4c-87b2-4afd-97ab-20cdb43038ae definiert. |