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

OpenVirtualDisk 関数に対する VirtualDiskAccessMask パラメーターに設定されたVIRTUAL_DISK_ACCESS_GET_INFO フラグを使用して開かれている必要がある、開いている VHD へのハンドル。 VHD を開く方法については、「 OpenVirtualDisk 関数」を参照してください。

[in, out] VirtualDiskInfoSize

VirtualDiskInfo パラメーターのサイズを含む ULONG へのポインター。

[in, out] VirtualDiskInfo

有効な GET_VIRTUAL_DISK_INFO 構造体へのポインター。 返されるデータの形式は、呼び出し元によって Version メンバーに渡される値によって異なります。

[in, out, optional] SizeUsed

使用されるサイズを含む ULONG へのポインター。

戻り値

要求の状態。

関数が成功した場合、戻り値は ERROR_SUCCESS され、 VirtualDiskInfo パラメーターには要求された情報が含まれます。

関数が失敗した場合、戻り値はエラー コードであり、 VirtualDiskInfo パラメーターは未定義です。 詳細については、「 システム エラー コード」を参照してください。

解説

getVirtualDiskInformation 関数は、VIRTUAL_DISK_ACCESS_GET_INFO フラグを使用してハンドルが開かれた場合、任意の有効な VirtualDiskHandle で呼び出すことができます。 VHD は、接続されているディスクである必要はありません。

要件

   
サポートされている最小のクライアント Windows 7
サポートされている最小のサーバー Windows Server 2008 R2
対象プラットフォーム Windows
ヘッダー virtdisk.h
Library VirtDisk.lib
[DLL] VirtDisk.dll

関連項目

VHD について

GET_VIRTUAL_DISK_INFO

VHD リファレンス