다음을 통해 공유


IWTSVirtualChannel::Write 메서드(tsvirtualchannels.h)

채널에서 쓰기 요청을 시작합니다. 모든 쓰기는 비동기식으로 간주됩니다. 이 메서드를 호출하면 pBuffer 의 내용이 복사되고 버퍼가 회수될 수 있도록 즉시 반환됩니다. 메모리 복사로 인해 Write() 호출이 너무 많을 경우 클라이언트에서 너무 많은 메모리를 할당할 수 있습니다.

이 채널의 Close() 호출은 보류 중인 쓰기를 취소합니다.

RDP 스택을 사용하는 경우 이 함수에 대한 호출당 작성할 수 있는 최대 제한은 1590바이트입니다. 이 제한을 초과하면 호출이 실패하지 않습니다. 제한에 대한 자세한 내용은 DVC 프로토콜 사양 2.2.3.1 DVC Data First PDU(DYNVC_DATA_FIRST)에서 확인할 수 있습니다.

구문

HRESULT Write(
  [in]           ULONG    cbSize,
  [in]           BYTE     *pBuffer,
  [in, optional] IUnknown *pReserved
);

매개 변수

[in] cbSize

쓸 버퍼의 크기(바이트)입니다.

[in] pBuffer

데이터를 쓸 채널의 버퍼에 대한 포인터입니다. 호출이 반환되는 즉시 이 버퍼를 다시 사용할 수 있습니다.

[in, optional] pReserved

다음에 사용하도록 예약됩니다. 값은 NULL이어야 합니다.

반환 값

성공하면 S_OK 반환합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 tsvirtualchannels.h

추가 정보

IWTSVirtualChannel