Méthode IMsRdpClientNonScriptable::NotifyRedirectDeviceChange

Article
06/13/2023

Avertit le module de redirection d’appareil du contrôle Bureau à distance ActiveX qu’un changement d’appareil s’est produit sur le système. Cette méthode transmet WM_DEVICECHANGE notifications au contrôle.

Syntaxe

HRESULT NotifyRedirectDeviceChange(
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Paramètres

wParam [in]: Spécifie l’événement d’appareil. Ce paramètre peut prendre les valeurs suivantes.
DBT_CONFIGCHANGECANCELED: Une demande de modification de la configuration actuelle (dock ou undock) a été annulée.
DBT_CONFIGCHANGED: La configuration actuelle a changé en raison d’un dock ou d’undock.
DBT_CUSTOMEVENT: Un événement personnalisé s’est produit.
DBT_DEVICEARRIVAL: Un appareil a été inséré et est désormais disponible.
DBT_DEVICEQUERYREMOVE: L’autorisation est demandée pour supprimer un appareil. N’importe quelle application peut refuser cette demande et annuler la suppression.
DBT_DEVICEQUERYREMOVEFAILED: Une demande de suppression d’un appareil a été annulée.
DBT_DEVICEREMOVECOMPLETE: Un appareil a été supprimé.
DBT_DEVICEREMOVEPENDING: Un appareil est sur le point d’être supprimé. La suppression ne peut pas être refusée.
DBT_DEVICETYPESPECIFIC: Un événement spécifique à l’appareil s’est produit.
DBT_DEVNODES_CHANGED: Un appareil a été ajouté ou supprimé du système.
DBT_QUERYCHANGECONFIG: L’autorisation est demandée pour modifier la configuration actuelle (dock ou undock).
DBT_USERDEFINED: La signification de ce message est définie par l’utilisateur.

lParam [in]

Pointeur vers une structure qui contient des données spécifiques à un événement. Son format dépend de la valeur du paramètre wParam . Pour plus d’informations, reportez-vous à la documentation de chaque événement. Pour plus d’informations, consultez Types d’événements d’appareil.

Valeur retournée

Retournez S_OK en cas de réussite.

Notes

Une application conteneur qui permet l’ajout ou la suppression dynamique d’appareils doit traiter le message WM_DEVICECHANGE dans sa fenêtre de niveau supérieur et transférer le message au contrôle à l’aide de la méthode NotifyRedirectDeviceChange . Un exemple de changement d’appareil dynamique est lorsqu’un lecteur de disque redirigé est ajouté ou supprimé pendant que le système est en cours d’exécution.

Pour plus d’informations sur la connexion Web Bureau à distance, consultez Configuration requise pour la connexion Web Bureau à distance.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Bibliothèque de types	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClientNonScriptable est défini comme 2f079c4c-87b2-4afd-97ab-20cdb43038ae

Voir aussi

IMsRdpClientNonScriptable2
IMsRdpClientNonScriptable3
IMsRdpClientNonScriptable4
IMsRdpClientNonScriptable5
IMsRdpClientNonScriptable