共用方式為

GetVirtualDiskInformation 函式 (virtdisk.h)

  • 發行項

擷取虛擬硬碟 (VHD) 的相關資訊。

語法

DWORD GetVirtualDiskInformation(
  [in]                HANDLE                 VirtualDiskHandle,
  [in, out]           PULONG                 VirtualDiskInfoSize,
  [in, out]           PGET_VIRTUAL_DISK_INFO VirtualDiskInfo,
  [in, out, optional] PULONG                 SizeUsed
);

參數

[in] VirtualDiskHandle

已開啟 VHD 的控制碼，必須使用VirtualDiskAccessMask參數中設定的VIRTUAL_DISK_ACCESS_GET_INFO旗標開啟，才能開啟該VHD。 如需如何開啟 VHD 的詳細資訊，請參閱 OpenVirtualDisk 函 式。

[in, out] VirtualDiskInfoSize

ULONG的指標，其中包含VirtualDiskInfo參數的大小。

[in, out] VirtualDiskInfo

有效 GET_VIRTUAL_DISK_INFO 結構的指標。 傳回的資料格式取決於呼叫端在 Version 成員中傳遞的值。

[in, out, optional] SizeUsed

ULONG的指標，其中包含所使用的大小。

傳回值

要求的狀態。

如果函式成功，傳回值會 ERROR_SUCCESS ，而 VirtualDiskInfo 參數會包含要求的資訊。

如果函式失敗，傳回值為錯誤碼，且 VirtualDiskInfo 參數未定義。 如需詳細資訊，請參閱 系統錯誤碼。

備註

只要使用VIRTUAL_DISK_ACCESS_GET_INFO旗標開啟控制碼，就可以在任何有效的VirtualDiskHandle上呼叫GetVirtualDiskInformation函式。 VHD 不一定是連結的磁片。

規格需求

   
最低支援的用戶端 Windows 7
最低支援的伺服器 Windows Server 2008 R2
目標平台 Windows
標頭 virtdisk.h
程式庫 VirtDisk.lib
Dll VirtDisk.dll

另請參閱

關於 VHD

GET_VIRTUAL_DISK_INFO

VHD 參考