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	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClient è definito come 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Vedi anche

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

IMsTscAxEvents::OnConfirmClose

IMsTscAxEvents::OnDisconnected