Compartir a través de


Método IVdsService::CleanupObsoleteMountPoints (vds.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Quita las rutas de acceso en modo de usuario y las carpetas montadas para los volúmenes que ya no existen.

Sintaxis

HRESULT CleanupObsoleteMountPoints();

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.

Código o valor devuelto Descripción
S_OK
Las rutas de acceso obsoletas en modo de usuario y las carpetas montadas se quitaron correctamente.
VDS_E_INITIALIZED_FAILED
0x80042401L
VDS no se pudo inicializar. Si una aplicación llama a este método antes de que el servicio termine de inicializarse, el método se bloqueará hasta que se complete la inicialización. Si se produce un error en la inicialización, se devuelve este error.

Comentarios

De forma predeterminada, el registro conserva la información de asignación de letras de unidad para los volúmenes desinstalados. Si el disco que contiene el volumen se quita del equipo, se conserva la entrada del Registro para que, si el disco y el volumen vuelven al mismo equipo, el volumen recibe la misma letra de unidad. Si el disco se mueve a un nuevo equipo, las entradas del Registro no se mueven con él, por lo que el volumen podría recibir una letra de unidad y un GUID de volumen diferentes.

El método CleanupObsoleteMountPoints quita estas entradas del Registro. Hay tres tipos de entradas del Registro que se quitan:

  • Si el volumen no tiene una letra de unidad o un GUID de volumen, tiene una entrada del Registro "sin letra de unidad", que este método quita.
  • De lo contrario, el volumen tiene entradas del Registro para un GUID de volumen y, posiblemente, una letra de unidad. Este método quita ambos.
Además, si el volumen contiene carpetas montadas, CleanupObsoleteMountPoints los quita. Por ejemplo, si se quita Volume1 en Disk1 y Volume1 se monta como x:\MountVolume1 en Disk2, también se elimina la carpeta \MountVolume1 en Disk2 .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vds.h
Library Uuid.lib

Consulte también

IVdsService