Metodo IRDPSRAPIVirtualChannelManager::CreateVirtualChannel (rdpencomapi.h)

Articolo
03/01/2024

Crea un canale virtuale.

Sintassi

HRESULT CreateVirtualChannel(
  [in]  BSTR                    bstrChannelName,
  [in]  CHANNEL_PRIORITY        Priority,
  [in]  unsigned long           ChannelFlags,
  [out] IRDPSRAPIVirtualChannel **ppChannel
);

Parametri

[in] bstrChannelName

Tipo: BSTR

Nome del canale. La lunghezza massima è di 8 caratteri, tra cui il carattere null-terminazione. I nomi dei canali legacy sono limitati a 32 caratteri.

[in] Priority

Tipo: CHANNEL_PRIORITY

Priorità del canale. Questo parametro può avere uno dei valori seguenti.

CHANNEL_PRIORITY_LO

CHANNEL_PRIORITY_MED

CHANNEL_PRIORITY_HI

[in] ChannelFlags

Tipo: unsigned long

Flag che determinano la modalità di invio dei dati nel canale. Questo parametro può essere 0 o CHANNEL_FLAGS_UNCOMPRESSED.

[out] ppChannel

Tipo: IRDPSRAPIVirtualChannel**

Puntatore dell'interfaccia IRDPSRAPIVirtualChannel .

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, il valore restituito è un codice di errore. Di seguito è riportato un valore possibile.

Commenti

Quando viene creato un canale virtuale, un canale virtuale RDP è associato al livello dello stack RDP per ogni canale aperto. Affinché un canale venga effettivamente aperto tra il client e il server, sia il client che il server devono associare il canale. Il parametro Priority viene usato per assegnare una priorità ai pacchetti inviati nel canale.

L'associazione tra i canali server e client viene stabilita in base al nome del canale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	rdpencomapi.h
DLL	RdpEncom.dll

Vedi anche

IRDPSRAPIVirtualChannelManager

Condividi tramite