Функция GetVirtualDiskPhysicalPath (virtdisk.h)

Получает путь к объекту физического устройства, который содержит виртуальный жесткий диск (VHD) или CD-файл или DVD-образ (ISO).

Синтаксис

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

Параметры

[in] VirtualDiskHandle

Дескриптор открытого виртуального диска, который должен быть открыт с помощью флага VIRTUAL_DISK_ACCESS_GET_INFO. Сведения о том, как открыть виртуальный диск, см. в функции OpenVirtualDisk.

[in, out] DiskPathSizeInBytes

Размер буфера в байтах, на который указывает параметр DiskPath.

[out, optional] DiskPath

Целевой буфер для получения пути физического диска, содержащего виртуальный диск.

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

Состояние запроса.

Если функция выполнена успешно, возвращаемое значение ERROR_SUCCESS, а параметр DiskPath содержит указатель на заполненную строку.

Если функция завершается ошибкой, возвращаемое значение является кодом ошибки и значением содержимого буфера, на который ссылается параметр DiskPath DiskPath, не определен. Дополнительные сведения см. в системных кодов ошибок.

Замечания

Для успешной функции GetVirtualDiskPhysicalPath виртуальный диск, на который ссылается параметр VirtualDiskHandle, необходимо подключить объект физического диска, который должен находиться системой, а параметр DiskPath должен ссылаться на буфер достаточно большой, чтобы сохранить результирующий путь. Этот путь находится в форме \\.\PhysicalDriveX, где X представляет собой целое число, представляющее конкретное перечисление физического диска в системе вызывающего объекта.

Файлы образов CD и DVD (ISO) не поддерживаются до Windows 8 и Windows Server 2012.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7
минимальный поддерживаемый сервер	Windows Server 2008 R2
целевая платформа	Виндоус
заголовка	virtdisk.h
библиотеки	VirtDisk.lib
DLL	VirtDisk.dll

См. также

О VHD

Справочник по VHD