IByteBuffer::Clone 메서드
[ Clone 메서드는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. Windows Server 2003 SP1(서비스 팩 1) 이상, Windows Vista, Windows Server 2008 및 이후 버전의 운영 체제에서는 사용할 수 없습니다. IStream 인터페이스는 비슷한 기능을 제공합니다.]
Clone 메서드는 원래 IByteBuffer 개체와 동일한 바이트를 참조하는 자체 검색 포인터를 사용하여 새 개체를 만듭니다.
구문
HRESULT Clone(
[out] LPBYTEBUFFER *ppByteBuffer
);
매개 변수
-
ppByteBuffer [out]
-
성공하면 새 스트림 개체에 대한 IByteBuffer 포인터의 위치를 가리킵니다. IByteBuffer 포인터 사용을 마쳤으면 IUnknown::Release 함수를 호출하여 해제합니다. 오류가 발생하면 이 매개 변수는 NULL입니다.
반환 값
반환 값은 HRESULT입니다. S_OK 값은 호출이 성공했음을 나타냅니다.
설명
이 메서드는 동일한 바이트에 액세스하지만 별도의 검색 포인터를 사용하기 위한 새 스트림 개체를 만듭니다. 새 스트림 개체는 원본 스트림 개체와 동일한 데이터를 봅니다. 한 개체에 기록된 변경 내용은 다른 개체에 즉시 표시됩니다. 범위 잠금은 스트림 개체 간에 공유됩니다.
복제된 스트림 instance 검색 포인터의 초기 설정은 복제 작업 시 원래 스트림에서 검색 포인터의 현재 설정과 동일합니다.
예제
다음 예제에서는 IByteBuffer 인터페이스를 복제하는 방법을 보여줍니다.
HRESULT hr;
// Clone the buffer.
hr = pIByteBuff->Clone(&pIByteClone);
if (FAILED(hr))
printf("Failed IByteBuffer::Clone\n");
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 클라이언트 지원 종료 |
Windows XP |
| 서버 지원 종료 |
Windows Server 2003 |
| 헤더 |
|
| 유형 라이브러리 |
|
| DLL |
|
| IID |
IID_IByteBuffer E126F8FE-A7AF-11D0-B88A-00C04FD424B9로 정의됩니다. |