Метод CreateClone класса MSFT_VirtualDisk
Создает клон виртуального диска, в результате чего создается новый виртуальный диск, данные которого идентичны данным исходного виртуального диска.
Синтаксис
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 , когда запрос выполняется долго. Если задание хранилища создано для отслеживания операции, этот метод возвращает параметры метода Checked — Job Started.
Примечание
Даже если 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 |