CHANNEL_INIT_EVENT_FN funzione di callback (cchannel.h)
Funzione di callback definita dall'applicazione che Servizi Desktop remoto chiama per notificare alla DLL client gli eventi del canale virtuale.
Il tipo PCHANNEL_INIT_EVENT_FN definisce un puntatore a questa funzione di callback. VirtualChannelInitEvent è un segnaposto per il nome della funzione definita dall'applicazione o definita dalla libreria.
Sintassi
CHANNEL_INIT_EVENT_FN ChannelInitEventFn;
VOID VCAPITYPE ChannelInitEventFn(
[in] LPVOID pInitHandle,
[in] UINT event,
[in] LPVOID pData,
[in] UINT dataLength
)
{...}
Parametri
[in] pInitHandle
Gestire la connessione client. Si tratta dell'handle restituito nel parametro ppInitHandle della funzione VirtualChannelInit .
[in] event
Indica l'evento che ha causato la notifica. Questo parametro può avere uno dei valori seguenti.
CHANNEL_EVENT_INITIALIZED (0)
L'inizializzazione del client RdC (Remote Desktop Connection) è stata completata. Il parametro pData è NULL.
CHANNEL_EVENT_CONNECTED (1)
È stata stabilita una connessione con un server Host sessione Desktop remoto che supporta i canali virtuali. Il parametro pData è un puntatore a una stringa con terminazione Null con il nome del server.
CHANNEL_EVENT_V1_CONNECTED (2)
È stata stabilita una connessione con un server Host sessione Desktop remoto che non supporta i canali virtuali. Il parametro pData è NULL.
CHANNEL_EVENT_DISCONNECTED (3)
La connessione al server Host sessione Desktop remoto è stata disconnessa. Il parametro pData è NULL.
CHANNEL_EVENT_TERMINATED (4)
Il client è stato terminato. Il parametro pData è NULL.
CHANNEL_EVENT_REMOTE_CONTROL_START (5)
È stata avviata un'operazione di controllo remoto. Il parametro pData è NULL.
CHANNEL_EVENT_REMOTE_CONTROL_STOP (6)
Un'operazione di controllo remoto è stata terminata. Il parametro pData è un puntatore a una stringa con terminazione Null contenente il nome del server.
[in] pData
Puntatore a dati aggiuntivi per l'evento. Il tipo di dati dipende dall'evento, come descritto in precedenza nelle descrizioni degli eventi.
[in] dataLength
Specifica le dimensioni, in byte, dei dati nel buffer pData .
Valore restituito
Questa funzione non restituisce un valore.
Commenti
La DLL client usa la funzione VirtualChannelInit per registrare la funzione VirtualChannelInitEvent con Servizi Desktop remoto.
Questa funzione è reentrant per ogni handle.This function is reentrant on a-handle basis. La funzione può essere chiamata durante l'esecuzione, ma non nello stesso handle più volte.
Questa funzione viene chiamata solo dopo il completamento di VirtualChannelEntry .
CHANNEL_EVENT_CONNECTED e CHANNEL_EVENT_DISCONNECTED notifiche degli eventi non verranno inviate se la connessione viene trasferita a un'altra sessione. Tuttavia, il plug-in lato server che gestisce la sessione a cui viene trasferita la connessione riceverà una notifica di riconnessione. È possibile usare uno strumento lato server, ad esempio Tscon.exe, per trasferire le connessioni. Per altre informazioni sulle notifiche di riconnessione, vedere Monitoraggio Connections sessione e Disconnessione.
Se il plug-in modalità utente deve ricevere una notifica che è stata riconnessa (ad esempio, se deve reimpostarne lo stato), il plug-in lato server deve inviare un messaggio di notifica al client. Questa notifica deve usare il protocollo usato dai plug-in per comunicare tra loro.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | cchannel.h |