Méthode IMsRdpClientNonScriptable::NotifyRedirectDeviceChange
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 |
|
| DLL |
|
| IID |
IID_IMsRdpClientNonScriptable est défini comme 2f079c4c-87b2-4afd-97ab-20cdb43038ae |