Метод Clear класса MSFT_Disk
Удаляет сведения о секции и не инициализирует диск, возвращая его в состояние RAW.
Синтаксис
UInt32 Clear(
[in] Boolean RemoveData,
[in] Boolean RemoveOEM,
[in] Boolean ZeroOutEntireDisk,
[out] String ExtendedStatus
);
Параметры
RemoveData [in]
Значение TRUE , если можно удалить секции данных с диска. Если этот параметр имеет значение FALSE или NULL, этот метод завершится ошибкой при наличии секции данных.
RemoveOEM [in]
Значение TRUE , если удалить OEM и другие специальные секции можно. Если этот параметр имеет значение FALSE или не указан, этот метод завершится ошибкой при наличии секций этих типов.
ZeroOutEntireDisk [in]
Значение TRUE , если этот параметр указывает этому методу обнулить весь диск в дополнение к удалению всех сведений о секции. Если этот параметр имеет значение FALSE или NULL, обнуляются только первые и последние мегабайты диска.
ExtendedStatus [out]
Строка, содержащая внедренный объект MSFT_StorageExtendedStatus .
Этот параметр позволяет поставщику хранилища возвращать расширенные (зависящие от реализации) сведения об ошибках.
Возвращаемое значение
Успешно (0)
Не поддерживается (1)
Неуказаная ошибка (2)
Время ожидания (3)
Сбой (4)
Недопустимый параметр (5)
Диск используется (6)
Доступ запрещен (40001)
Недостаточно ресурсов для завершения операции. (40002)
Кэш устарел (40003)
Диск не инициализирован. (41000)
Диск доступен только для чтения. (41002)
Диск находится в автономном режиме. (41003)
Не удается очистить при наличии разделов OEM. Чтобы очистить разделы OEM, используйте флаг RemoveOEM. (41007)
Не удается очистить при наличии секций данных. Чтобы очистить секции данных, используйте флаг RemoveData. (41008)
Операция не поддерживается на критическом диске. (41009)
На устройстве нет носителя. (41015)
Указанный объект управляется компонентом Отказоустойчивая кластеризация Майкрософт. Для выполнения этой операции необходимо удалить диск из кластера. (41019)
Комментарии
Вызывающий объект должен указать RemoveData, RemoveOEM или и то, и другое, если только он не удалит все разделы данных, известные разделы OEM и разделы ESP на диске. Это требование исключает секции метаданных, такие как MSR, раздел метаданных LDM и неизвестные разделы OEM.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Пространство имен | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |