Funzione di callback VIRTUALCHANNELOPEN (cchannel.h)
Apre la fine del client di un canale virtuale.
Servizi Desktop remoto fornisce un puntatore a una funzione VirtualChannelOpen nella struttura CHANNEL_ENTRY_POINTS passata al punto di ingresso VirtualChannelEntry .
Sintassi
VIRTUALCHANNELOPEN Virtualchannelopen;
UINT VCAPITYPE Virtualchannelopen(
[in] LPVOID pInitHandle,
[out] LPDWORD pOpenHandle,
[in] PCHAR pChannelName,
[in] PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
)
{...}
Parametri
[in] pInitHandle
Gestire la connessione client. Questo è l'handle restituito nel parametro ppInitHandle della funzione VirtualChannelInit .
[out] pOpenHandle
Puntatore a una variabile che riceve un handle che identifica il canale virtuale aperto nelle chiamate successive alle funzioni VirtualChannelWrite e VirtualChannelClose .
[in] pChannelName
Puntatore a una stringa di caratteri ANSI con terminazione null contenente il nome del canale virtuale da aprire. Il nome deve essere stato registrato quando il client ha chiamato la funzione VirtualChannelInit .
[in] pChannelOpenEventProc
Puntatore a una funzione VirtualChannelOpenEvent definita dall'applicazione che Servizi Desktop remoto chiama per inviare una notifica alla DLL client di eventi per questo canale virtuale.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è CHANNEL_RC_OK.
Se si verifica un errore, la funzione restituisce uno dei valori seguenti.
Commenti
La DLL client non può chiamare questa funzione fino a quando il client non ha stabilito una connessione con un server host sessione Desktop remoto. La funzione VirtualChannelInitEvent riceve una notifica CHANNEL_EVENT_CONNECTED quando viene stabilita una connessione server host sessione Desktop remoto.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | cchannel.h |