IVdsServiceUninstallDisk::UninstallDisks メソッド (vds.h)

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

ディスクのセットをアンインストールします。

構文

HRESULT UninstallDisks(
  [in]  VDS_OBJECT_ID *pDiskIdArray,
  [in]  ULONG         ulCount,
  [in]  BOOLEAN       bForce,
  [out] BOOLEAN       *pbReboot,
  [out] HRESULT       *pResults
);

パラメーター

[in] pDiskIdArray

アンインストールするディスクごとに 1 つずつ、VDS オブジェクト ID の配列を含むバッファーのアドレス。 配列内の各 ID は一意である必要があります。

[in] ulCount

pDiskIdArray パラメーターが指すバッファー内の VDS オブジェクト ID の数。

[in] bForce

TRUE の場合、ボリュームをロックまたはマウント解除できない場合でも、VDS はディスクをアンインストールします。

[out] pbReboot

ユーザーがコンピューターを再起動してアンインストール プロセスを完了する必要がある場合に TRUE を受け取る BOOLEAN 変数のアドレス。

[out] pResults

HRESULT 値の呼び出し元によって割り当てられた配列のアドレス。 配列内の要素の数は、 pDiskIdArray パラメーターによって指されます。 この配列の最初の要素は、 pDiskIdArray 内の最初の要素に対応しています。 いずれかのディスクが正しく初期化されない場合は、この配列の対応する要素でエラーの特定のエラー コードが返されます。

戻り値

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

注釈

VDS は、このメソッドを実装します。

このメソッドは同期的であり、最初に指定されたディスク上のボリュームをアンインストールしてから、ディスクをアンインストールします。 ディスクがアンインストールされると、対応する LUN をマスク (非表示) または削除できます。

このメソッドは、ディスク上のボリュームに割り当てられたドライブ文字をクリーンアップします。 さらに、マウント解除ハンドルが閉じられた後、ディスクが実際に削除される前にボリュームが再マウントされないように、ボリュームをオフラインに設定します。

複数のディスクにまたがる動的ボリュームを削除する場合は、デバイス マネージャー関数を使用する代わりにこのメソッドを呼び出す必要があります。

UninstallDisks メソッドがサポートされていない Windows Server 2003 リリースのディスクをアンインストールする方法については、IVdsLun::SetMask メソッドの「解説」セクションを参照してください。

要件

こちらもご覧ください

IVdsServiceUninstallDisk