IVdsVolume::D elete メソッド (vds.h)
[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。
ボリュームとすべてのプレックスを削除し、エクステントを解放します。
構文
HRESULT Delete(
[in] BOOL bForce
);
パラメーター
[in] bForce
TRUE の場合、VDS は使用中であってもボリュームを削除します。それ以外の場合、ボリュームが使用中の場合、ボリュームは削除されません。
戻り値
このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、VDS 固有の戻り値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
プレックスは正常に削除されました。 |
解説
オンライン パックからのみボリュームを削除できます。 パックの状態がVDS_PS_ONLINEであることを確認するには、IVdsPack::GetProperties メソッドを使用します。
リムーバブル メディア上のボリュームを削除することはできません。
VDS はボリュームを削除する前にファイル システムをマウント解除します。これは FAT と FAT32 で必要な操作ですが、NTFS では必要ありません。 さらに、VDS は、ボリューム自体を削除した後、ボリュームへのすべてのアクセス パスを削除します。 マウント解除操作が失敗し、 bForce が true の場合、VDS はマウント解除なしでボリュームを削除します。 ファイル システム クライアント アプリケーションでは、この状況を処理する必要があります。 マウント解除に成功し、削除操作が失敗した場合、VDS はボリュームの再マウントを試みます。
VDS は、現在のシステム ボリュームとブート ボリューム、およびページファイル、クラッシュダンプ、休止状態ボリュームの削除を防止します。 クラッシュダンプとページファイルを移動またはリセットできます。 休止状態のボリュームはブート パーティションに残る必要があります。
Windows Server 2003: クラッシュダンプと休止状態のボリュームは、ブート パーティションに残しておく必要があります。
Windows Server 2003: ボリュームが削除されると、VDS はマウントされたフォルダーの削除を試みます。 これが失敗した場合、ボリュームが正常に削除された場合でも、 Delete は VDS_S_ACCESS_PATH_NOT_DELETEDを返します。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vds.h |
| Library | Uuid.lib |