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 參數所參考之緩衝區的內容值。 如需詳細資訊,請參閱 系統錯誤碼。
言論
若要讓 GetVirtualDiskPhysicalPath 函式成功,VirtualDiskHandle 參數所參考的虛擬磁碟必須連結,實體磁碟對象必須由系統找到,而 DiskPath 參數必須參考足以保存結果路徑的緩衝區。 此路徑的格式為 \\.\PhysicalDriveX,其中 X 是整數,代表呼叫端系統上實體磁碟的特定列舉。
Windows 8 和 Windows Server 2012 之前不支援 CD 和 DVD 影像檔案。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 7 |
支援的最低伺服器 | Windows Server 2008 R2 |
目標平臺 | 窗戶 |
標頭 | virtdisk.h |
連結庫 | VirtDisk.lib |
DLL | VirtDisk.dll |