共用方式為


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

另請參閱

關於 VHD

VHD 參考