Функция 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
Целевой буфер для получения пути физического диска, содержащего виртуальный диск.
Возвращаемое значение
Состояние запроса.
Если функция выполнена успешно, возвращаемое значение
Если функция завершается ошибкой, возвращаемое значение является кодом ошибки и значением содержимого буфера, на который ссылается параметр 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