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 |