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

Siehe auch

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsRdpClientNonScriptable