IRDPSRAPIVirtualChannelManager::CreateVirtualChannel 메서드(rdpencomapi.h)

가상 채널을 만듭니다.

구문

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

매개 변수

[in] bstrChannelName

형식: BSTR

채널 이름입니다. 최대 길이는 null 종료 문자를 포함하여 8자입니다. 레거시 채널 이름은 32자로 제한됩니다.

[in] Priority

형식: CHANNEL_PRIORITY

채널의 우선 순위입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

CHANNEL_PRIORITY_LO

CHANNEL_PRIORITY_MED

CHANNEL_PRIORITY_HI

[in] ChannelFlags

형식: unsigned long

채널에서 데이터를 보내는 방법을 결정하는 플래그입니다. 이 매개 변수는 0 또는 CHANNEL_FLAGS_UNCOMPRESSED 수 있습니다.

[out] ppChannel

형식: IRDPSRAPIVirtualChannel**

IRDPSRAPIVirtualChannel 인터페이스 포인터입니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 S_OK. 그렇지 않으면 반환 값이 오류 코드입니다. 다음은 가능한 값입니다.

설명

가상 채널을 만들면 RDP 가상 채널이 열린 각 채널의 RDP 스택 계층에 바인딩됩니다. 실제로 클라이언트와 서버 간에 채널을 열려면 클라이언트와 서버 모두 채널을 바인딩해야 합니다. Priority 매개 변수는 채널에서 보내는 패킷에 우선 순위를 할당하는 데 사용됩니다.

서버 채널과 클라이언트 채널 간의 바인딩은 채널 이름에 따라 설정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	rdpencomapi.h
DLL	RdpEncom.dll

추가 정보

IRDPSRAPIVirtualChannelManager