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を返します。

要件

関連項目

IVdsPack::GetProperties

IVdsVolume

VDS_PACK_STATUS