WTSVirtualChannelOpen 함수(wtsapi32.h)

지정된 가상 채널의 서버 끝에 대한 핸들을 엽니다.

이 함수는 사용되지 않습니다. 대신 WTSVirtualChannelOpenEx 함수를 사용합니다.

구문

HANDLE WTSVirtualChannelOpen(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] LPSTR  pVirtualName
);

[in] hServer

이 매개 변수는 WTS_CURRENT_SERVER_HANDLE 합니다.

[in] SessionId

원격 데스크톱 서비스 세션 식별자입니다. 현재 세션을 나타내려면 WTS_CURRENT_SESSION 지정합니다. WTSEnumerateSessions 함수를 사용하여 지정된 RD 세션 호스트 서버에서 모든 세션의 식별자를 검색할 수 있습니다.

다른 사용자의 세션에서 가상 채널을 열려면 가상 채널의 권한이 있어야 합니다. 자세한 내용은 원격 데스크톱 서비스 권한을 참조하세요. 세션에 대한 권한을 수정하려면 원격 데스크톱 서비스 구성 관리 도구를 사용합니다.

[in] pVirtualName

가상 채널 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 유니코드가 정의된 경우에도 ANSI 문자열입니다. 가상 채널 이름은 종료 null을 포함하지 않고 1~CHANNEL_NAME_LEN 문자로 구성됩니다.

함수가 성공하면 반환 값은 지정된 가상 채널에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

핸들 사용을 마쳤으면 WTSVirtualChannelClose 함수를 호출하여 해제합니다.

비동기 I/O에 사용할 수 있는 가상 채널 파일 핸들에 액세스하는 방법을 보여 주는 예제는 WTSVirtualChannelQuery를 참조하세요.

이 함수를 사용하여 동일한 가상 채널을 여러 번 열려고 하면 10초 지연이 발생하고 설정된 채널이 중단될 수 있습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	wtsapi32.h
라이브러리	Wtsapi32.lib
DLL	Wtsapi32.dll
API 세트	ext-ms-win-session-wtsapi32-l1-1-0(Windows 8 도입)