QueryChangesVirtualDisk 함수(virtdisk.h)

RCT(복원력 있는 변경 내용 추적)로 추적되는 VHD(가상 하드 디스크)의 지정된 영역에 대한 변경 내용에 대한 정보를 검색합니다.

구문

DWORD QueryChangesVirtualDisk(
  [in]      HANDLE                            VirtualDiskHandle,
  [in]      PCWSTR                            ChangeTrackingId,
  [in]      ULONG64                           ByteOffset,
  [in]      ULONG64                           ByteLength,
  [in]      QUERY_CHANGES_VIRTUAL_DISK_FLAG   Flags,
  [out]     PQUERY_CHANGES_VIRTUAL_DISK_RANGE Ranges,
  [in, out] PULONG                            RangeCount,
  [out]     PULONG64                          ProcessedLength
);

매개 변수

[in] VirtualDiskHandle

OpenVirtualDisk 함수에 대한 VirtualDiskAccessMask 매개 변수에 설정된 VIRTUAL_DISK_ACCESS_GET_INFO 플래그를 사용하여 열어야 하는 열린 VHD에 대한 핸들입니다. VHD를 여는 방법에 대한 자세한 내용은 OpenVirtualDisk 함수를 참조하세요.

[in] ChangeTrackingId

VHD의 지정된 영역이 변경되었는지 여부를 확인하기 위해 비교의 기준으로 사용할 가상 디스크의 상태를 식별하는 변경 내용에 대한 변경 내용 추적 식별자를 지정하는 문자열에 대한 포인터입니다.

[in] ByteOffset

VHD 시작부터 변경에 대해 검사 VHD 영역의 시작 부분까지의 거리를 바이트 단위로 지정하는 부호 없는 긴 정수입니다.

[in] ByteLength

변경에 검사 VHD 영역의 길이를 바이트 단위로 지정하는 부호 없는 긴 정수입니다.

[in] Flags

예약되어 있습니다. 를 QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE.

[out] Ranges

ByteOffset 및 ByteLength 매개 변수가 ChangeTrackingId 매개 변수가 지정한 변경 내용 추적 식별자가 봉인된 이후 변경된 영역을 지정하는 영역 내의 가상 디스크 영역을 나타내는 QUERY_CHANGES_VIRTUAL_DISK_RANGE 구조체의 배열입니다.

[in, out] RangeCount

부호 없는 긴 정수의 주소입니다. 입력에서 값은 Ranges 매개 변수가 가리키는 배열이 보유할 수 있는 QUERY_CHANGES_VIRTUAL_DISK_RANGE 구조체의 수를 나타냅니다. 출력에서 값은 메서드가 배열에 배치한 QUERY_CHANGES_VIRTUAL_DISK_RANGE 구조체의 수를 포함합니다.

[out] ProcessedLength

메서드가 처리한 총 바이트 수를 나타내는 부호 없는 긴 정수에 대한 포인터로, BytesLength 매개 변수가 Ranges 매개 변수가 지정하는 배열의 사용 가능한 공간에서 변경 내용이 캡처되었음을 지정하는 영역의 양을 나타냅니다.

반환 값

요청의 상태입니다.

함수가 성공하면 반환 값이 ERROR_SUCCESSRanges 매개 변수에 요청된 정보가 포함됩니다.

함수가 실패하면 반환 값은 오류 코드입니다. 자세한 내용은 시스템 오류 코드를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016
대상 플랫폼	Windows
헤더	virtdisk.h
라이브러리	VirtDisk.lib
DLL	VirtDisk.dll

추가 정보

VHD 정보

QUERY_CHANGES_VIRTUAL_DISK_RANGE

VHD 참조