Метод CreateSnapshot класса MSFT_VirtualDisk
Создает новый виртуальный диск, который является теневой копией существующего виртуального диска.
Синтаксис
UInt32 CreateSnapshot(
[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]
Пул носителей, который должен использоваться для хранения созданного snapshot. Если этот параметр не задан, этот метод по умолчанию будет использовать тот же пул носителей, который содержит исходный виртуальный диск.
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 |
| Заголовок | Dbdaoint.h |
| MOF | Storagewmi.mof |