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 |