IByteBuffer::CopyTo 메서드
[ CopyTo 메서드는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. Windows Server 2003 SP1(서비스 팩 1) 이상, Windows Vista, Windows Server 2008 및 이후 버전의 운영 체제에서는 사용할 수 없습니다. IStream 인터페이스는 비슷한 기능을 제공합니다.]
CopyTo 메서드는 개체의 현재 검색 포인터에서 다른 개체의 현재 검색 포인터로 지정된 바이트 수를 복사합니다.
구문
HRESULT CopyTo(
[in] LPBYTEBUFFER *pByteBuffer,
[in] LONG cb,
[out] LONG *pcbRead,
[out] LONG *pcbWritten
);
매개 변수
-
pByteBuffer [in]
-
대상 스트림을 가리킵니다. pByteBuffer가 가리키는 스트림은 새 스트림 또는 원본 스트림의 복제본일 수 있습니다.
-
cb [in]
-
원본 스트림에서 복사할 바이트 수입니다.
-
pcbRead [out]
-
이 메서드가 원본에서 읽은 실제 바이트 수를 쓰는 위치에 대한 포인터입니다. 이 포인터를 NULL 로 설정하여 이 값에 관심이 없음을 나타낼 수 있습니다. 이 경우 이 메서드는 읽은 실제 바이트 수를 제공하지 않습니다.
-
pcbWritten [out]
-
이 메서드가 대상에 기록된 실제 바이트 수를 쓰는 위치에 대한 포인터입니다. 이 포인터를 NULL 로 설정하여 이 값에 관심이 없음을 나타낼 수 있습니다. 이 경우 이 메서드는 작성된 실제 바이트 수를 제공하지 않습니다.
반환 값
반환 값은 HRESULT입니다. S_OK 값은 호출이 성공했음을 나타냅니다.
설명
이 메서드는 지정된 바이트를 한 스트림에서 다른 스트림으로 복사합니다. 스트림을 자체에 복사하는 데 사용할 수도 있습니다. 각 스트림 instance 검색 포인터는 읽거나 쓰는 바이트 수에 맞게 조정됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 클라이언트 지원 종료 |
Windows XP |
| 서버 지원 종료 |
Windows Server 2003 |
| 헤더 |
|
| 유형 라이브러리 |
|
| DLL |
|
| IID |
IID_IByteBuffer E126F8FE-A7AF-11D0-B88A-00C04FD424B9로 정의됩니다. |