Compartir a través de

Función GetVirtualDiskPhysicalPath (virtdisk.h)

  • Artículo

Recupera la ruta de acceso al objeto de dispositivo físico que contiene un disco duro virtual (VHD) o un archivo de imagen de CD o DVD (ISO).

Sintaxis

DWORD GetVirtualDiskPhysicalPath(
  [in]            HANDLE VirtualDiskHandle,
  [in, out]       PULONG DiskPathSizeInBytes,
  [out, optional] PWSTR  DiskPath
);

Parámetros

[in] VirtualDiskHandle

Identificador del disco virtual abierto, que debe haberse abierto con la marca VIRTUAL_DISK_ACCESS_GET_INFO. Para obtener información sobre cómo abrir un disco virtual, consulte la función OpenVirtualDisk.

[in, out] DiskPathSizeInBytes

Tamaño, en bytes, del búfer al que apunta el parámetro DiskPath.

[out, optional] DiskPath

Búfer de destino para recibir la ruta de acceso del dispositivo de disco físico que contiene el disco virtual.

Valor devuelto

Estado de la solicitud.

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS y el parámetro DiskPath contiene un puntero a una cadena rellenada.

Si se produce un error en la función, el valor devuelto es un código de error y el valor del contenido del búfer al que hace referencia el parámetro DiskPath no está definido. Para obtener más información, vea códigos de error del sistema.

Observaciones

Para que la función GetVirtualDiskPhysicalPath de se realice correctamente, el disco virtual al que hace referencia el parámetro VirtualDiskHandle debe estar conectado, el objeto de disco físico debe estar ubicado por el sistema y el parámetro DiskPath debe hacer referencia a un búfer lo suficientemente grande como para contener la ruta de acceso resultante. Esta ruta de acceso tiene el formato \\.\ PhysicalDriveX, donde X es un entero que representa la enumeración concreta del disco físico en el sistema del autor de la llamada.

Los archivos de imagen de CD y DVD (ISO) no se admiten antes de Windows 8 y Windows Server 2012.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 7
servidor mínimo admitido Windows Server 2008 R2
de la plataforma de destino de Windows
encabezado de virtdisk.h
biblioteca de VirtDisk.lib
DLL de VirtDisk.dll

Consulte también

Acerca de la VHD

de referencia de VHD