Compartir a través de

Método IVdsVolumeMF::D eleteAccessPath (vds.h)

  • Artículo

[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 la ruta de acceso del volumen actual.

Sintaxis

HRESULT DeleteAccessPath(
  [in] LPWSTR pwszPath,
  [in] BOOL   bForce
);

Parámetros

[in] pwszPath

Cadena que contiene la ruta de acceso que se va a quitar. Una ruta de acceso puede ser una letra de unidad o una ruta de acceso a un directorio vacío en un volumen NTFS. Si es una letra de unidad, debe incluir una barra diagonal inversa final, por ejemplo, "F:". Si es una ruta de acceso a un directorio, la barra diagonal inversa final no es necesaria, por ejemplo, "C:\MyFolder\MyDocuments".

[in] bForce

Si es TRUE, la ruta de acceso se elimina incondicionalmente, incluso si el volumen está en uso. Este parámetro solo es significativo cuando la ruta de acceso es una letra de unidad.

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
 El método se completó correctamente.
VDS_E_OPERATION_DENIED
0x8004240AL
 La ruta de acceso conduce al volumen del sistema, el volumen de arranque, el volumen crashdump, el volumen de hibernación o el volumen pagefile. No se puede quitar la letra de unidad de estos volúmenes.
VDS_E_PATH_NOT_FOUND
0x80042416L
 No se encuentra la ruta de acceso especificada.
VDS_E_DEVICE_IN_USE
0x80042413L
 La ruta de acceso se eliminó correctamente; sin embargo, se produjo un error. VDS posiblemente no pudo actualizar el atributo de tabla de particiones GUID (GPT) de una partición o no pudo eliminar un recurso compartido de red predeterminado (como F$) al eliminar la letra de unidad.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Error en el volumen.
VDS_E_PACK_OFFLINE
0x80042444L
 No se puede acceder al paquete que contiene el volumen.

Comentarios

Si no hay identificadores abiertos en el volumen, la letra de unidad se quita inmediatamente. Sin embargo, si hay identificadores abiertos en el volumen, el volumen no se puede bloquear y la letra de unidad se quita cuando se reinicia el equipo.

Requisitos

   
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

IVdsVolumeMF

IVdsVolumeMF::AddAccessPath

IVdsVolumeMF::QueryAccessPaths