IVdsDiskPartitionMF2::FormatPartitionEx2 メソッド (vds.h)
[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられます。
既存の OEM、ESP、または不明なパーティションを書式設定します。 このメソッドは IVdsDiskPartitionMF::FormatPartition メソッドと同じですが、 Options パラメーターを 使用して書式設定オプションを指定する点が異なります。
構文
HRESULT FormatPartitionEx2(
[in] ULONGLONG ullOffset,
[in] LPWSTR pwszFileSystemTypeName,
[in] USHORT usFileSystemRevision,
[in] ULONG ulDesiredUnitAllocationSize,
[in] LPWSTR pwszLabel,
[in] DWORD Options,
[out] IVdsAsync **ppAsync
);
パラメーター
[in] ullOffset
ディスクの先頭からのパーティションのバイト オフセット。 このオフセットは、パーティションの先頭のオフセットである必要があります。
[in] pwszFileSystemTypeName
パーティションのフォーマットに使用するファイル システムの名前を含む NULL で終わる Unicode 文字列。 NULL または "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 プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。
| リターン コード/値 | 説明 |
|---|---|
|
ボリュームが正常にパーティション分割されました。 |
|
プロバイダーが不適切なデータを返しました。 |
|
この操作は、リムーバブル メディアではサポートされていません。 |
|
既定のファイル システムを特定できませんでした。 |
|
ディスクがありません。 |
|
パーティションが存在しません。 |
|
操作は、OEM 以外のパーティションではサポートされていません。 |
さらに、 IVdsAsync インターフェイスは、次の関連する警告とエラー コードを返すことができます。
| リターン コード/値 | Description |
|---|---|
|
ファイル システムはフォーマットされていますが、圧縮されていません。 |
|
アクセスが拒否されました。 |
|
ラベルが無効です。 |
|
ボリュームをクイックフォーマットすることはできません。 |
|
クラスターの数が大きすぎるため、32 ビット整数として表されません。 |
|
クラスターのサイズが大きすぎるため、書式設定が可能です。 |
|
クラスターのサイズが小さすぎて書式設定が可能です。 |
|
ファイル システムに互換性がありません。 |
|
メディアに互換性がありません。 |
|
フォーマット中に I/O エラーが発生しました。 |
|
メディアは書き込み保護されています。 |
|
ボリューム サイズが大きすぎてフォーマットが行えなすぎます。 |
|
ボリューム サイズが小さすぎて書式設定が行えなすぎます。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vds.h |