Metodo IMsRdpClient::RequestClose
Richiede un arresto normale del controllo ActiveX Desktop remoto. Un arresto normale può includere la fine della sessione servizi Desktop remoto dell'utente, ma non arresta il server Host sessione Desktop remoto (Host sessione Desktop remoto).
Sintassi
HRESULT RequestClose(
[out] ControlCloseStatus *pCloseStatus
);
Parametri
-
pCloseStatus [out]
-
Valore dell'enumerazione ControlCloseStatus che indica se l'applicazione può chiudere immediatamente il controllo. Di seguito è riportato un elenco di valori possibili.
-
controlCloseCanProceed (0x0000)
-
L'applicazione contenitore può continuare a chiudere immediatamente il controllo. Questo valore può anche indicare che la connessione è già stata terminata.
-
controlCloseWaitForEvents (0x0001)
-
L'applicazione contenitore non deve chiudere immediatamente il controllo; l'applicazione deve attendere che uno degli eventi descritti nella sezione Osservazioni seguenti venga eseguito prima della chiusura.
Valore restituito
Restituisce S_OK se ha esito positivo.
Commenti
Se il parametro pCloseStatus è uguale a controlCloseWaitForEvents, l'applicazione deve attendere che si verifichi uno degli eventi seguenti prima che l'applicazione chiude il controllo:
- IMsTscAxEvents::OnDisconnected. Se l'utente non è connesso alla sessione Servizi Desktop remoto, l'applicazione può chiamare la funzione DestroyWindow per eliminare tutte le finestre e quindi chiudere il controllo.
- IMsTscAxEvents::OnConfirmClose. Se l'utente è connesso alla sessione Servizi Desktop remoto, il controllo attiva un evento OnConfirmClose . Questo evento consente all'applicazione di richiedere all'utente se chiudere la connessione. Se l'utente risponde sì al prompt, l'applicazione contenitore può chiamare DestroyWindow per eliminare tutte le finestre e chiudere il controllo.
RequestClose consente a un'applicazione contenitore di richiedere all'utente se chiudere una connessione. Per altre informazioni, vedere IMsTscAxEvents::OnConfirmClose.
Per altre informazioni sulla connessione Web Desktop remoto, vedere Requisiti per la connessione Web Desktop remoto.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Libreria dei tipi |
|
| DLL |
|
| IID |
IID_IMsRdpClient è definito come 92b4a539-7115-4b7c-a5a9-e5d9efc2780a |