Метод IVdsService::CleanupObsoleteMountPoints (vds.h)

[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Удаляет пути в пользовательском режиме и подключенные папки для томов, которые больше не существуют.

Синтаксис

HRESULT CleanupObsoleteMountPoints();

Возвращаемое значение

Этот метод может возвращать стандартные значения HRESULT , такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать коды преобразованных системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.

Возвращаемый код/значение	Описание
S_OK	Устаревшие пути в пользовательском режиме и подключенные папки были успешно удалены.
VDS_E_INITIALIZED_FAILED 0x80042401L	Не удалось инициализировать VDS. Если приложение вызывает этот метод до завершения инициализации службы, метод блокируется до завершения инициализации. Если инициализация завершается сбоем, возвращается эта ошибка.

Комментарии

По умолчанию реестр сохраняет сведения о сопоставлении букв диска для удаленных томов. Если диск, содержащий том, удаляется с компьютера, запись реестра сохраняется, поэтому, если диск и том возвращаются на один и тот же компьютер, том получает одну и ту же букву диска. При перемещении диска на новый компьютер записи реестра не перемещаются вместе с ним, поэтому том может получить другую букву диска и GUID тома.

Метод CleanupObsoleteMountPoints удаляет эти записи реестра. Существует три типа записей реестра, которые удаляются:

• Если у тома нет буквы диска или GUID тома, у него есть запись реестра "нет буквы диска", которая удаляется этим методом.
• В противном случае том содержит записи реестра для GUID тома и, возможно, буквы диска. Оба метода удаляются этим методом.

Кроме того, если том содержит подключенные папки, cleanupObsoleteMountPoints удаляет их. Например, если volume1 на диске Disk1 удаляется, а volume1 подключен как x:\MountVolume1 на диске 2, папка \MountVolume1 на диске 2 также удаляется.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	vds.h
Библиотека	Uuid.lib

См. также раздел

IVdsService