Méthode IMsRdpClient::RequestClose
Demande un arrêt normal du contrôle ActiveX bureau à distance. Un arrêt normal peut inclure la fin de la session des services Bureau à distance de l’utilisateur, mais il n’arrête pas le serveur Hôte de session Bureau à distance (hôte de session Bureau à distance).
Syntaxe
HRESULT RequestClose(
[out] ControlCloseStatus *pCloseStatus
);
Paramètres
-
pCloseStatus [out]
-
Valeur de l’énumération ControlCloseStatus qui indique si l’application peut fermer le contrôle immédiatement. Voici la liste des valeurs possibles.
-
controlCloseCanProceed (0x0000)
-
L’application conteneur peut procéder à la fermeture immédiate du contrôle. Cette valeur peut également indiquer que la connexion est déjà terminée.
-
controlCloseWaitForEvents (0x0001)
-
L’application conteneur ne doit pas fermer immédiatement le contrôle ; l’application doit attendre que l’un des événements décrits dans la section Remarques suivante se produise avant de se fermer.
Valeur retournée
Retournez S_OK en cas de réussite.
Notes
Si le paramètre pCloseStatus est égal à controlCloseWaitForEvents, l’application doit attendre que l’un des événements suivants se produise avant que l’application ferme le contrôle :
- IMsTscAxEvents::OnDisconnected. Si l’utilisateur n’est pas connecté à la session Services Bureau à distance, l’application peut appeler la fonction DestroyWindow pour détruire toutes les fenêtres, puis fermer le contrôle.
- IMsTscAxEvents::OnConfirmClose. Si l’utilisateur est connecté à la session Services Bureau à distance, le contrôle déclenche un événement OnConfirmClose . Cet événement permet à l’application d’inviter l’utilisateur à fermer la connexion. Si l’utilisateur répond oui à l’invite, l’application conteneur peut appeler DestroyWindow pour détruire toutes les fenêtres et fermer le contrôle.
RequestClose permet à une application conteneur d’inviter l’utilisateur à fermer une connexion. Pour plus d’informations, consultez IMsTscAxEvents::OnConfirmClose.
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_IMsRdpClient est défini comme 92b4a539-7115-4b7c-a5a9-e5d9efc2780a |