Share via

Método IVdsVolumeMF::AddAccessPath (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.]

Agrega una ruta de acceso.

Sintaxis

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

Parámetros

[in] pwszPath

Cadena que indica la ruta de acceso, que es una ruta de acceso en modo de usuario que se puede usar para abrir el volumen. Una ruta de acceso puede ser una letra de unidad o una ruta de acceso a un directorio vacío en un volumen NTFS. La cadena de ruta de acceso debe incluir una barra diagonal inversa final, por ejemplo, "F:".

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 pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Código o valor devuelto Descripción
S_OK
 La ruta de acceso se agregó correctamente.
S_FALSE
 Sin embargo, se ha agregado correctamente la ruta de acceso. VDS posiblemente no pudo actualizar el atributo GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER de una partición o no pudo agregar un recurso compartido de red predeterminado (por ejemplo, F$) al agregar la letra de unidad. Para obtener más información, consulte PARTITION_INFORMATION_GPT.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Error en el volumen.
VDS_E_PACK_OFFLINE
0x80042444L
 El paquete que contiene el volumen no es accesible.

Comentarios

VDS agrega la ruta de acceso mediante la creación de una carpeta montada (también denominada punto de montaje de volumen). Tenga en cuenta que las carpetas montadas solo se admiten en volúmenes NTFS. Para obtener más información, vea Carpetas montadas.

Este método devuelve ERROR_DIR_NOT_EMPTY si el parámetro pwszPath contiene una ruta de acceso a una carpeta montada que ya está en uso (incluso si el directorio está vacío) o si pwszPath contiene una ruta de acceso a un directorio no vacío.

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

SetVolumeMountPoint