MSFT_Volume クラスの Format メソッド

ボリュームをフォーマットします。

構文

UInt32 Format(
  [in]  String  FileSystem,
  [in]  String  FileSystemLabel,
  [in]  UInt32  AllocationUnitSize,
  [in]  Boolean Full,
  [in]  Boolean Force,
  [in]  Boolean Compress,
  [in]  Boolean ShortFileNameSupport,
  [in]  Boolean SetIntegrityStreams,
  [in]  Boolean UseLargeFRS,
  [in]  Boolean DisableHeatGathering,
  [out] String  FormattedVolume,
  [out] String  ExtendedStatus
);

パラメーター

FileSystem [in]

ボリュームに適用するファイル システム。 次のいずれか:

• "ExFAT"
• "FAT"
• "FAT32"
• "NTFS"
• "ReFS"

FileSystemLabel [in]

ボリュームのファイル システム ラベル。

AllocationUnitSize [in]

割り当てユニット サイズ (バイト単位)。

Full [in]

完全形式の場合は TRUE、クイック形式の場合は FALSE。

Force [in]

形式操作を強制する場合は TRUE。それ以外の場合は FALSE。

Compress [in]

ボリュームを圧縮する場合は TRUE。それ以外の場合は FALSE。 FileSystem が ReFS に設定されている場合、未定義のままにします。

ShortFileNameSupport [in]

ボリュームが短い名前をサポートする必要がある場合は TRUE。それ以外の場合は FALSE。 FileSystem が ReFS に設定されている場合、未定義のままにします。

SetIntegrityStreams [in]

整合性ストリームを設定する場合は TRUE。 FileSystem が ReFS に設定されていない場合、未定義のままにします。

UseLargeFRS [in]

大きな FRS を使用する場合は TRUE。それ以外の場合は FALSE。 FileSystem が ReFS に設定されている場合、未定義のままにします。

DisableHeatGathering [in]

熱収集を無効にする場合は TRUE、それ以外の場合は FALSE。

FormattedVolume [out]

書式設定されたボリュームを表す MSFT_Volume オブジェクトを受け取ります。

ExtendedStatus [out]

埋め込み MSFT_StorageExtendedStatus オブジェクトを含みます。

このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有の) エラー情報を返すことができます。

戻り値

成功 (0)

サポートされていません (1)

不明なエラー (2)

タイムアウト (3)

失敗 (4)

無効なパラメーター (5)

このコマンドは、x64 環境で実行されている x86 ではサポートされていません。 (7)

アクセスが拒否されました (40001)

予期しない I/O エラーが発生しました (40004)

指定されたオブジェクトは、Microsoft フェールオーバー クラスタリング コンポーネントによって管理されます。 この操作を実行するには、ディスクがクラスター メンテナンス モードで、クラスター リソースの状態がオンラインである必要があります。 (40018)

この操作は、システムまたは重要なパーティションでは許可されません。 (42010)

指定されたクラスター サイズが無効です (43000)

指定されたファイル システムはサポートされていません (43001)

ボリュームをクイック フォーマットすることはできません (43002)

クラスターの数が 32 ビットを超えています (43003)

指定された UDF バージョンはサポートされていません (43004)

クラスター サイズは、ディスクの物理セクター サイズの倍数である必要があります (43005)

ドライブが読み取り専用の場合、要求された操作を実行できません (43006)

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
名前空間	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

関連項目

MSFT_Volume