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 도입) |