IVdsService::CleanupObsoleteMountPoints メソッド (vds.h)
[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。
存在しなくなったボリュームのユーザー モード パスとマウントされたフォルダーを削除します。
構文
HRESULT CleanupObsoleteMountPoints();
戻り値
このメソッドは、E_INVALIDARGやE_OUTOFMEMORY、VDS 固有の戻り値など、標準の HRESULT 値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。
| リターン コード/値 | 説明 |
|---|---|
|
古いユーザー モード パスとマウントされたフォルダーが正常に削除されました。 |
|
VDS の初期化に失敗しました。 サービスの初期化が完了する前にアプリケーションがこのメソッドを呼び出すと、初期化が完了するまでメソッドはブロックされます。 初期化が失敗した場合、このエラーが返されます。 |
注釈
既定では、レジストリはアンインストールされたボリュームのドライブ文字マッピング情報を保持します。 ボリュームを含むディスクがコンピューターから削除されると、レジストリ エントリが保持されるため、ディスクとボリュームが同じコンピューターに戻った場合、ボリュームは同じドライブ文字を受け取ります。 ディスクが新しいコンピューターに移動された場合、レジストリ エントリは移動しないため、ボリュームが別のドライブ文字とボリューム GUID を受け取る可能性があります。
CleanupObsoleteMountPoints メソッドは、これらのレジストリ エントリを削除します。 削除されるレジストリ エントリには、次の 3 種類があります。
- ボリュームにドライブ文字またはボリューム GUID がない場合は、このメソッドによって削除される "ドライブ文字なし" レジストリ エントリがあります。
- それ以外の場合、ボリュームにはボリューム GUID とドライブ文字のレジストリ エントリが含まれます。 どちらもこのメソッドによって削除されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vds.h |
| Library | Uuid.lib |