MSFT_VirtualDisk 클래스의 CreateClone 메서드
가상 디스크의 복제본을 만들어 데이터가 원래 가상 디스크와 동일한 새 가상 디스크를 만듭니다.
구문
UInt32 CreateClone(
[in] String FriendlyName,
[in] String TargetStoragePoolName,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String CreatedVirtualDisk,
[out] String ExtendedStatus
);
매개 변수
FriendlyName [in]
가상 디스크 복제본의 원하는 이름입니다.
이 매개 변수는 필수이며 NULL일 수 없습니다.
TargetStoragePoolName [in]
만든 클론을 저장하는 데 사용해야 하는 스토리지 풀입니다. 이 매개 변수가 설정되지 않은 경우 이 메서드는 기본적으로 원본 가상 디스크를 포함하는 동일한 스토리지 풀을 사용합니다.
RunAsJob [in]
TRUE이면 요청이 서비스에 오래 걸리는 경우 이 메서드는 CreatedStorageJob 매개 변수를 사용합니다. 작업을 추적하기 위해 스토리지 작업을 만든 경우 이 메서드는 메서드 매개 변수 선택됨 - 작업이 시작된 것을 반환합니다.
참고
RunAsJob이 TRUE인 경우에도 이 메서드는 충분한 시간 내에 완료된 경우에도 결과를 반환할 수 있습니다.
FALSE 또는 NULL인 경우 이 메서드는 호출에 대한 클라이언트의 메서드에 의해 결정되는 기본 WMI 비동기 동작을 따릅니다. 즉, 달리 요청하지 않는 한 동기적입니다.
CreatedStorageJob [out]
RunAsJob이 TRUE로 설정되어 있고 이 메서드를 실행하는 데 시간이 오래 걸리는 경우 이 매개 변수는 장기 실행 작업을 추적하는 데 사용되는 스토리지 작업 개체에 대한 참조를 받습니다.
CreatedVirtualDisk [out]
가상 디스크가 성공적으로 만들어지면 이 매개 변수는 포함된 MSFT_VirtualDisk 개체가 포함된 문자열을 받습니다.
ExtendedStatus [out]
포함된 MSFT_StorageExtendedStatus 개체를 포함하는 문자열입니다.
이 매개 변수를 사용하면 스토리지 공급자가 확장(구현별) 오류 정보를 반환할 수 있습니다.
반환 값
성공 (0)
지원되지 않음 (1)
지정되지 않은 오류 (2)
시간 제한 (3)
실패( 4)
잘못된 매개 변수 (5)
메서드 매개 변수 선택됨 - 작업 시작 됨(4096)
여유 공간이 부족 함(40000)
액세스 거부됨 (40001)
작업을 완료하는 데 충분한 리소스가 없습니다. (40002)
캐시 만료 (40003)
스토리지 공급자에 연결할 수 없습니다. (46000)
스토리지 공급자는 스토리지 하위 시스템에 연결할 수 없습니다. (46001)
이 작업은 기본 스토리지 풀에서 지원되지 않습니다. (48000)
스토리지 풀은 특별한 용도로만 예약되어 있습니다. (48001)
지정된 스토리지 풀을 찾을 수 없습니다. (48005)
스토리지 풀의 상태 또는 작동 상태 허용하지 않으므로 작업을 완료할 수 없습니다. (48006)
설명
이 메서드는 원본 가상 디스크의 데이터와 동일한 새 가상 디스크를 만듭니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 네임스페이스 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |