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

Vedi anche

VirtualChannelInit