MSFT_Disk 类的 Clear 方法

删除分区信息并取消初始化磁盘,使其返回到 RAW 状态。

语法

UInt32 Clear(
  [in]  Boolean RemoveData,
  [in]  Boolean RemoveOEM,
  [in]  Boolean ZeroOutEntireDisk,
  [out] String  ExtendedStatus
);

参数

RemoveData [in]

如果可以从磁盘中删除数据分区,则为 TRUE。 如果此参数为 FALSENULL,则此方法在存在数据分区时将失败。

RemoveOEM [in]

如果可以删除 OEM 和其他特殊分区,则为 TRUE。 如果此参数为 FALSE 或未指定,则此方法在存在这些类型的分区时会失败。

ZeroOutEntireDisk [in]

如果此参数指示此方法除删除所有分区信息外,还要将整个磁盘归零,则为 TRUE。 如果此参数为 FALSENULL,则仅将磁盘的第一个和最后一兆字节归零。

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)

指定的对象由 Microsoft 故障转移群集组件管理。 必须从群集中删除磁盘才能执行此操作。 (41019)

注解

调用方必须指定 RemoveData 和/或 RemoveOEM,除非它首先删除磁盘上的所有数据分区、已知 OEM 分区和 ESP 分区。 此要求不包括元数据分区,例如 MSR、LDM 元数据分区和未知 OEM 分区。

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
命名空间 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

另请参阅

MSFT_Disk