VIRTUALCHANNELOPEN 콜백 함수(cchannel.h)
가상 채널의 클라이언트 끝을 엽니다.
원격 데스크톱 서비스는 VirtualChannelEntry 진입점에 전달된 CHANNEL_ENTRY_POINTS 구조체의 VirtualChannelOpen 함수에 대한 포인터를 제공합니다.
구문
VIRTUALCHANNELOPEN Virtualchannelopen;
UINT VCAPITYPE Virtualchannelopen(
[in] LPVOID pInitHandle,
[out] LPDWORD pOpenHandle,
[in] PCHAR pChannelName,
[in] PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
)
{...}
매개 변수
[in] pInitHandle
클라이언트 연결에 대한 핸들입니다. VirtualChannelInit 함수의 ppInitHandle 매개 변수에 반환된 핸들입니다.
[out] pOpenHandle
VirtualChannelWrite 및 VirtualChannelClose 함수에 대한 후속 호출에서 열린 가상 채널을 식별하는 핸들을 수신하는 변수에 대한 포인터입니다.
[in] pChannelName
열 가상 채널의 이름을 포함하는 null로 끝나는 ANSI 문자열에 대한 포인터입니다. 클라이언트가 VirtualChannelInit 함수를 호출할 때 이름이 등록되어 있어야 합니다.
[in] pChannelOpenEventProc
원격 데스크톱 서비스가 이 가상 채널에 대한 이벤트를 클라이언트 DLL에 알리기 위해 호출하는 애플리케이션 정의 VirtualChannelOpenEvent 함수에 대한 포인터입니다.
반환 값
함수가 성공하면 반환 값이 CHANNEL_RC_OK.
오류가 발생하면 함수는 다음 값 중 하나를 반환합니다.
설명
클라이언트 DLL은 클라이언트가 RD 세션 호스트 서버와의 연결을 설정할 때까지 이 함수를 호출할 수 없습니다. RD 세션 호스트 서버 연결이 설정되면 VirtualChannelInitEvent 함수는 CHANNEL_EVENT_CONNECTED 알림을 받습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | cchannel.h |