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_SUCCESSDiskPath 매개 변수에 채워진 문자열에 대한 포인터가 포함됩니다.

함수가 실패하면 반환 값은 오류 코드이며 DiskPath 매개 변수에서 참조하는 버퍼의 내용 값은 정의되지 않습니다. 자세한 내용은 시스템 오류 코드를 참조하세요.

설명

GetVirtualDiskPhysicalPath 함수가 성공하려면 VirtualDiskHandle 매개 변수에서 참조하는 가상 디스크를 연결해야 하고, 실제 디스크 개체를 시스템에서 찾아야 하며, DiskPath 매개 변수는 결과 경로를 보유할 수 있을 만큼 큰 버퍼를 참조해야 합니다. 이 경로는 \.\PhysicalDriveX 형식입니다. 여기서 X 는 호출자 시스템에서 실제 디스크의 특정 열거형을 나타내는 정수입니다.

CD 및 DVD 이미지 파일(ISO)은 Windows 8 및 Windows Server 2012 전에 지원되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7
지원되는 최소 서버	Windows Server 2008 R2
대상 플랫폼	Windows
헤더	virtdisk.h
라이브러리	VirtDisk.lib
DLL	VirtDisk.dll

추가 정보

VHD 정보

VHD 참조