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 の場合、ディスクの最初と最後のメガバイトのみがゼロになります。
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 パーティションなどのメタデータ パーティションは除外されます。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 名前空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |