IStream::Clone 메서드(objidl.h)
Clone 메서드는 원래 스트림과 동일한 바이트를 참조하는 자체 검색 포인터를 사용하여 새 스트림 개체를 만듭니다.
구문
HRESULT Clone(
[out] IStream **ppstm
);
매개 변수
[out] ppstm
성공하면 새 스트림 개체에 대한 IStream 포인터의 위치에 대한 포인터입니다. 오류가 발생하면 이 매개 변수는 NULL입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 스트림이 성공적으로 복제되었습니다. |
| E_PENDING | 비동기 스토리지만 해당: 스트림 데이터의 일부 또는 전체를 현재 사용할 수 없습니다. |
| STG_E_INSUFFICIENTMEMORY | 메모리 부족으로 인해 스트림이 복제되지 않았습니다. |
| STG_E_INVALIDPOINTER | ppStm 포인터가 잘못되었습니다. |
| STG_E_REVERTED | 개체가 트랜잭션 트리에서 위의 되돌리기 작업에 의해 무효화되었습니다. |
설명
Clone 메서드는 동일한 바이트에 액세스하지만 별도의 검색 포인터를 사용하기 위해 새 스트림 개체를 만듭니다. 새 스트림 개체는 원본 스트림 개체와 동일한 데이터를 봅니다. 한 개체에 기록된 변경 내용은 다른 개체에 즉시 표시됩니다. 범위 잠금은 스트림 개체 간에 공유됩니다.
복제된 스트림 instance 검색 포인터의 초기 설정은 복제 작업 시 원래 스트림에서 검색 포인터의 현재 설정과 동일합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | objidl.h |
| 라이브러리 | Uuid.lib |
| DLL | Ole32.dll |