IVdsVolumeMF3::FormatEx2 メソッド (vds.h)
[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。
パーティション上のファイル システム ボリュームを書式設定します。 このメソッドは IVdsVolumeMF2::FormatEx メソッドと同じですが、書式設定オプションは Options パラメーターを使用して指定される点が除きます。
構文
HRESULT FormatEx2(
[in] LPWSTR pwszFileSystemTypeName,
[in] USHORT usFileSystemRevision,
[in] ULONG ulDesiredUnitAllocationSize,
[in] LPWSTR pwszLabel,
[in] DWORD Options,
[out] IVdsAsync **ppAsync
);
パラメーター
[in] pwszFileSystemTypeName
ボリュームのフォーマットに使用するファイル システムの名前を含む null で終わる Unicode 文字列。 このパラメーターには 、NULL または Windows ファイル システムの名前を指定できます。 "NTFS"、"FAT"、"FAT32"、"UDF"、"EXFAT" のファイル システムがサポートされています。 このパラメーターが NULL の場合は、既定のファイル システムが使用されます。 詳細については、「 VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG」を参照してください。
[in] usFileSystemRevision
ファイル システムのリビジョン (存在する場合)。 このメンバーは 16 ビットの 2 進コード 10 進数で表されます。ここで、小数点は 2 桁目と 3 桁目の間に暗黙的に指定されます。 たとえば、0x0250 の値はリビジョン 2.50 を示します。
[in] ulDesiredUnitAllocationSize
ファイル システムの割り当て単位のサイズ (バイト単位)。 値は 2 の累乗である必要があります。 値が 0 の場合は、ファイル システムの種類によって決定される既定の割り当て単位が使用されます。 割り当て単位の範囲は、ファイル システムに依存します。
[in] pwszLabel
新しいファイル システムに割り当てる null で終わる Unicode 文字列。 ラベルの最大サイズはファイル システムによって異なります。
[in] Options
書式設定オプションを指定 VDS_FORMAT_OPTION_FLAGS 列挙値のビットマスク。
[out] ppAsync
正常に完了すると IVdsAsync インターフェイスを受け取り、この操作を監視および制御する IVdsAsync インターフェイスへのポインター。 呼び出し元は、受信したインターフェイスが完了したら、それを解放する必要があります。
戻り値
このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、VDS 固有の戻り値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。
| リターン コード/値 | 説明 |
|---|---|
|
ファイル システムが正常に書式設定されました。 |
|
呼び出し元がシステム、ブート、クラッシュダンプ、休止状態、またはページファイル ボリュームのフォーマットを試みると、操作は拒否されます。 |
|
ボリュームが失敗しました。 |
|
ボリュームを含むパックにアクセスできません。 オフライン パック内のすべてのボリュームにアクセスできません。 |
|
既定のファイル システムを特定できませんでした。 |
さらに、 IVdsAsync インターフェイスは、次の関連する警告とエラー コードを返すことができます。
| リターン コード/値 | 説明 |
|---|---|
|
ファイル システムに互換性がありません。 |
|
メディアに互換性がありません。 |
|
アクセスが拒否されました。 |
|
メディアは書き込み保護されています。 |
|
ラベルが無効です。 |
|
ボリュームをクイックフォーマットすることはできません。 |
|
フォーマット中に I/O エラーが発生しました。 |
|
ボリューム サイズが小さすぎて書式設定が行えなすぎます。 |
|
ボリューム サイズが大きすぎてフォーマットが行えなすぎます。 |
|
クラスターのサイズが小さすぎて書式設定が可能です。 |
|
クラスターのサイズが大きすぎるため、書式設定が可能です。 |
|
クラスターの数が大きすぎるため、32 ビット整数として表されません。 |
|
ファイル システムはフォーマットされていますが、圧縮されていません。 |
|
ボリュームに対して BitLocker 暗号化を無効にできませんでした。 |
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vds.h |
| Library | Uuid.lib |