Funzione di callback VIRTUALCHANNELOPEN (cchannel.h)

Articolo
02/26/2024

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