WTSVirtualChannelOpenEx 함수(wtsapi32.h)
WTSVirtualChannelOpen과 유사한 방식으로 가상 채널을 만듭니다.
이 API는 SVC(정적 가상 채널) 및 DVC(동적 가상 채널) 만들기를 모두 지원합니다. flags 매개 변수가 0이면 WTSVirtualChannelOpen과 동일하게 동작합니다. 적절한 플래그를 지정하여 DVC를 열 수 있습니다. DVC를 만든 후에는 SVC에 사용되는 읽기, 쓰기, 쿼리 또는 닫기와 동일한 함수를 사용할 수 있습니다.
구문
HANDLE WTSVirtualChannelOpenEx(
[in] DWORD SessionId,
[in] LPSTR pVirtualName,
[in] DWORD flags
);
매개 변수
[in] SessionId
원격 데스크톱 서비스 세션 식별자입니다. 현재 세션을 나타내려면 WTS_CURRENT_SESSION 지정합니다. WTSEnumerateSessions 함수를 사용하여 지정된 RD 세션 호스트 서버에서 모든 세션의 식별자를 검색할 수 있습니다.
다른 사용자의 세션에서 가상 채널을 열려면 가상 채널 권한이 있어야 합니다. 자세한 내용은 원격 데스크톱 서비스 권한을 참조하세요. 세션에 대한 권한을 수정하려면 원격 데스크톱 서비스 구성 관리 도구를 사용합니다.
[in] pVirtualName
SVC의 경우 는 가상 채널 이름을 포함하는 null로 끝나는 문자열을 가리킵니다. SVC 이름의 길이는 종료 null을 포함하지 않고 CHANNEL_NAME_LEN 문자로 제한됩니다.
DVC의 경우 는 수신기의 엔드포인트 이름을 포함하는 null로 끝나는 문자열을 가리킵니다. DVC 이름의 길이는 MAX_PATH 문자로 제한됩니다.
[in] flags
채널을 SVC로 열려면 이 매개 변수에 대해 0을 지정합니다. 채널을 DVC로 열려면 WTS_CHANNEL_OPTION_DYNAMIC 지정합니다.
DVC를 열 때 WTS_CHANNEL_OPTION_DYNAMIC 값과 함께 WTS_CHANNEL_OPTION_DYNAMIC_PRI_XXX 값 중 하나를 지정하여 전송되는 데이터의 우선 순위 설정을 지정할 수 있습니다.
WTS_CHANNEL_OPTION_DYNAMIC_NO_COMPRESS
이 DVC에 대한 압축을 사용하지 않도록 설정합니다. 이 값을 WTS_CHANNEL_OPTION_DYNAMIC 값과 함께 지정해야 합니다.
WTS_CHANNEL_OPTION_DYNAMIC_PRI_LOW(기본값)
낮은 우선 순위. 데이터는 우선 순위가 낮은 양쪽에서 전송됩니다. 전송 속도가 중요하지 않은 모든 크기의 블록 전송에 이 우선 순위 수준을 사용합니다. 거의 모든 경우(95%)에서 이 플래그를 사용하여 채널을 열어야 합니다.
WTS_CHANNEL_OPTION_DYNAMIC_PRI_MED
중간 우선 순위입니다. 이 우선 순위 수준을 사용하여 우선 순위가 낮은 채널의 데이터보다 우선 순위가 있어야 하는 짧은 제어 메시지를 보냅니다.
WTS_CHANNEL_OPTION_DYNAMIC_PRI_HIGH
높은 우선 순위. 중요하고 사용자 환경에 직접적인 영향을 주는 데이터에 이 우선 순위 수준을 사용합니다. 전송 크기는 다를 수 있습니다. 표시 데이터는 이 범주에 속합니다.
WTS_CHANNEL_OPTION_DYNAMIC_PRI_REAL
실시간 우선 순위입니다. 데이터 전송이 절대적으로 중요한 경우에만 이 우선 순위 수준을 사용합니다. 데이터 전송 크기는 메시지당 몇 백 바이트로 제한되어야 합니다.
반환 값
GetLastError가 설정된 오류 발생 시 NULL입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | wtsapi32.h |
| 라이브러리 | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| API 세트 | ext-ms-win-session-wtsapi32-l1-1-0(Windows 8 도입) |