IVdsVolume::RemovePlex メソッド (vds.h)

[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられます。

指定した 1 つ以上のプレックスを現在のボリュームから削除し、エクステントを解放します。

構文

HRESULT RemovePlex(
  [in]  VDS_OBJECT_ID plexId,
  [out] IVdsAsync     **ppAsync
);

[in] plexId

削除するプレックスの GUID。

[out] ppAsync

VDS が戻り時に初期化する IVdsAsync インターフェイスポインターのアドレス。呼び出し元はインターフェイスを解放する必要があります。操作の状態を取り消す、待機する、またはクエリを実行するには、このポインターを使用します。

このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、VDS 固有の戻り値を返すことができます。また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステムエラーコードを返すこともできます。エラーは、VDS 自体または使用されている基になる VDS プロバイダーから発生する可能性があります。可能な戻り値は次のとおりです。

この操作では、ボリュームの最後のプレックスを削除できません。代わりに、 IVdsVolume::D elete メソッドを使用して、残りの最後のボリューム (唯一のプレックス) を削除します。このメソッドは、1 つのプレックスを持つ基本ボリュームでは無効です。

VDS は、プレックスを削除してもボリュームのマウントを解除しません。

実装者は、呼び出しが非同期操作を開始するかどうかに関係なく、このメソッドの IVdsAsync インターフェイスへのポインターを返す必要があります。