MSFT_Disk 類別的 Clear 方法

拿掉磁碟分區資訊，並將磁碟取消初始化，並將它傳回RAW狀態。

語法

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

參數

RemoveData [in]

如果 可以從磁碟中移除資料分割，則為TRUE。 如果此參數為 FALSE 或 NULL，則此方法會在資料分割存在時失敗。

RemoveOEM [in]

如果 可以移除 OEM 和其他特殊磁碟分區，則為 TRUE。 如果此參數為 FALSE 或未指定，此方法將會在這些類型的數據分割中失敗。

ZeroOutEntireDisk [in]

如果 這個參數指示這個方法除了移除所有磁碟分區資訊之外，還會將整個磁碟零，則為TRUE。 如果此參數為 FALSE 或 NULL，則只有磁碟的第一個和最後 MB 會零。

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)

備註

除非呼叫端先刪除磁碟上的所有數據分割、已知的 OEM 磁碟分區和 ESP 磁碟分區，否則呼叫端必須指定 RemoveData、 RemoveOEM 或兩者。 這項需求會排除元數據分割區，例如 MSR、LDM 元數據分割區，以及未知的 OEM 磁碟分區。

規格需求

另請參閱

MSFT_Disk