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 は、呼び出し元のシステム上の物理ディスクの特定の列挙体を表す整数です。

CD および DVD イメージ ファイル (ISO) は、Windows 8 および Windows Server 2012 より前はサポートされていません。

必要条件

要件	価値
サポートされる最小クライアント	Windows 7
サポートされる最小サーバー	Windows Server 2008 R2
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	virtdisk.h
ライブラリ	VirtDisk.lib
DLL	VirtDisk.dll

関連項目

VHD について

VHD リファレンス