CHANNEL_INIT_EVENT_FN 콜백 함수(cchannel.h)

원격 데스크톱 서비스에서 클라이언트 DLL에 가상 채널 이벤트를 알리기 위해 호출하는 애플리케이션 정의 콜백 함수입니다.

PCHANNEL_INIT_EVENT_FN 형식은 이 콜백 함수에 대한 포인터를 정의합니다. VirtualChannelInitEvent 는 애플리케이션 정의 또는 라이브러리 정의 함수 이름의 자리 표시자입니다.

구문

CHANNEL_INIT_EVENT_FN ChannelInitEventFn;

VOID VCAPITYPE ChannelInitEventFn(
  [in] LPVOID pInitHandle,
  [in] UINT event,
  [in] LPVOID pData,
  [in] UINT dataLength
)
{...}

매개 변수

[in] pInitHandle

클라이언트 연결에 대한 핸들입니다. VirtualChannelInit 함수의 ppInitHandle 매개 변수에 반환된 핸들입니다.

[in] event

알림을 발생시킨 이벤트를 나타냅니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

CHANNEL_EVENT_INITIALIZED(0)

RDC(원격 데스크톱 연결) 클라이언트 초기화가 완료되었습니다. pData 매개 변수는 NULL입니다.

CHANNEL_EVENT_CONNECTED (1)

가상 채널을 지원하는 RD 세션 호스트 서버와 연결이 설정되었습니다. pData 매개 변수는 서버 이름을 사용하여 null로 끝나는 문자열에 대한 포인터입니다.

CHANNEL_EVENT_V1_CONNECTED (2)

가상 채널을 지원하지 않는 RD 세션 호스트 서버와 연결이 설정되었습니다. pData 매개 변수는 NULL입니다.

CHANNEL_EVENT_DISCONNECTED (3)

RD 세션 호스트 서버에 대한 연결이 끊어졌습니다. pData 매개 변수는 NULL입니다.

CHANNEL_EVENT_TERMINATED (4)

클라이언트가 종료되었습니다. pData 매개 변수는 NULL입니다.

CHANNEL_EVENT_REMOTE_CONTROL_START (5)

원격 제어 작업이 시작되었습니다. pData 매개 변수는 NULL입니다.

CHANNEL_EVENT_REMOTE_CONTROL_STOP (6)

원격 제어 작업이 종료되었습니다. pData 매개 변수는 서버 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] pData

이벤트에 대한 추가 데이터에 대한 포인터입니다. 데이터 형식은 이벤트 설명의 앞부분에서 설명한 대로 이벤트에 따라 달라집니다.

[in] dataLength

pData 버퍼에 있는 데이터의 크기(바이트)를 지정합니다.

반환 값

이 함수는 값을 반환하지 않습니다.

설명

클라이언트 DLL은 VirtualChannelInit 함수를 사용하여 VirtualChannelInitEvent 함수를 원격 데스크톱 서비스에 등록합니다.

이 함수는 핸들별로 재진입됩니다. 함수가 실행되는 동안 호출될 수 있지만 동일한 핸들에서 두 번 이상 호출되지는 않습니다.

이 함수는 VirtualChannelEntry 가 완료된 후에만 호출됩니다.

CHANNEL_EVENT_CONNECTED 및 CHANNEL_EVENT_DISCONNECTED 이벤트 알림은 연결이 다른 세션으로 전송되는 경우 전송되지 않습니다. 그러나 연결이 전송되는 세션을 관리하는 서버 쪽 플러그 인은 다시 연결 알림을 받습니다. Tscon.exe 같은 서버 쪽 도구를 사용하여 연결을 전송할 수 있습니다. 다시 연결 알림에 대한 자세한 내용은 모니터링 세션 Connections 및 연결 끊기를 참조하세요.

사용자 모드 플러그 인이 다시 연결되었다는 알림을 받아야 하는 경우(예: 상태를 다시 설정해야 하는 경우) 서버 쪽 플러그 인은 클라이언트에 알림 메시지를 보내야 합니다. 이 알림은 플러그 인이 서로 통신하는 데 사용하는 프로토콜을 사용해야 합니다.

요구 사항

추가 정보

VirtualChannelInit