VIRTUALCHANNELWRITE 콜백 함수(cchannel.h)

가상 채널의 클라이언트 끝에서 서버 끝의 파트너 애플리케이션으로 데이터를 보냅니다.

원격 데스크톱 서비스는 VirtualChannelEntry 진입점에 전달된 CHANNEL_ENTRY_POINTS 구조의 VirtualChannelWrite 함수에 대한 포인터를 제공합니다.

구문

VIRTUALCHANNELWRITE Virtualchannelwrite;

UINT VCAPITYPE Virtualchannelwrite(
  [in] DWORD openHandle,
  [in] LPVOID pData,
  [in] ULONG dataLength,
  [in] LPVOID pUserData
)
{...}

매개 변수

[in] openHandle

가상 채널에 대한 핸들입니다. VirtualChannelOpen 함수의 pOpenHandle 매개 변수에 반환된 핸들입니다.

[in] pData

쓸 데이터를 포함하는 버퍼에 대한 포인터입니다.

[in] dataLength

쓸 pData 버퍼의 데이터 바이트 수를 지정합니다.

[in] pUserData

애플리케이션 정의 값입니다. 이 값은 쓰기 작업이 완료되거나 취소될 때 VirtualChannelOpenEvent 함수에 전달됩니다.

반환 값

함수가 성공하면 반환 값이 CHANNEL_RC_OK.

오류가 발생하면 함수는 다음 값 중 하나를 반환합니다.

설명

VirtualChannelWrite 함수는 비동기입니다. 쓰기 작업이 완료되면 VirtualChannelOpenEvent 함수가 CHANNEL_EVENT_WRITE_COMPLETE 알림을 받습니다. 해당 알림이 수신될 때까지 호출자는 VirtualChannelWrite에 전달된 pData 버퍼를 해제하거나 다시 사용하지 않아야 합니다.

쓰기 작업이 완료되거나 취소될 때 pUserData 매개 변수에 지정된 값이 VirtualChannelOpenEvent 함수에 전달됩니다. 이 데이터를 사용하여 쓰기 작업을 식별할 수 있습니다.

가상 채널의 서버 끝에 있는 서버 추가 기능은 WTSVirtualChannelRead 함수를 호출하여 VirtualChannelWrite 호출로 작성된 데이터를 읽습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	cchannel.h

추가 정보

VirtualChannelOpen

VirtualChannelOpenEvent

WTSVirtualChannelRead