Compartilhar via


Método IRDPSRAPIVirtualChannelManager::CreateVirtualChannel (rdpencomapi.h)

Cria um canal virtual.

Sintaxe

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

Parâmetros

[in] bstrChannelName

Tipo: BSTR

O nome do canal. O comprimento máximo é de 8 caracteres, incluindo o caractere de terminação nula. Os nomes de canais herdados são limitados a 32 caracteres.

[in] Priority

Tipo: CHANNEL_PRIORITY

A prioridade do canal. Esse parâmetro pode usar um dos valores a seguir.

CHANNEL_PRIORITY_LO

CHANNEL_PRIORITY_MED

CHANNEL_PRIORITY_HI

[in] ChannelFlags

Tipo: long sem sinal

Sinalizadores que determinam como os dados são enviados no canal. Esse parâmetro pode ser 0 ou CHANNEL_FLAGS_UNCOMPRESSED.

[out] ppChannel

Tipo: IRDPSRAPIVirtualChannel**

Um ponteiro de interface IRDPSRAPIVirtualChannel .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o valor retornado será um código de erro. Veja a seguir um valor possível.

Comentários

Quando um canal virtual é criado, um canal virtual RDP é associado à camada de pilha RDP para cada canal aberto. Para que um canal seja realmente aberto entre o cliente e o servidor, o cliente e o servidor precisam associar o canal. O parâmetro Priority é usado para atribuir uma prioridade aos pacotes enviados no canal.

A associação entre os canais do servidor e do cliente é estabelecida com base no nome do canal.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho rdpencomapi.h
DLL RdpEncom.dll

Confira também

IRDPSRAPIVirtualChannelManager