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
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID _ IMsRdpClientNonScriptable ist als 2f079c4c-87b2-4afd-97ab-20cdb43038ae definiert.

Siehe auch

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsRdpClientNonScriptable