Функция QueryChangesVirtualDisk (virtdisk.h)

Статья
08/27/2023

Извлекает сведения об изменениях в указанных областях виртуального жесткого диска (VHD), отслеживаемых с помощью устойчивого отслеживания изменений (RCT).

Синтаксис

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

Дескриптор открытого виртуального жесткого диска, который должен быть открыт с помощью флага VIRTUAL_DISK_ACCESS_GET_INFO , установленного в параметре VirtualDiskAccessMask для функции OpenVirtualDisk . Сведения об открытии виртуального жесткого диска см. в разделе Функция OpenVirtualDisk .

[in] ChangeTrackingId

Указатель на строку, указывающую идентификатор отслеживания изменений для изменения, идентифицирующий состояние виртуального диска, который вы хотите использовать в качестве основы для сравнения, чтобы определить, изменилась ли указанная область виртуального жесткого диска.

[in] ByteOffset

Длинное целое число без знака, указывающее расстояние от начала виртуального жесткого диска до начала области виртуального жесткого диска, которую вы хотите проверка для изменений в байтах.

[in] ByteLength

Длинное целое число без знака, указывающее длину области виртуального жесткого диска, который вы хотите проверка для изменений, в байтах.

[in] Flags

Зарезервировано. Задайте значение QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE.

[out] Ranges

Массив QUERY_CHANGES_VIRTUAL_DISK_RANGE структур, указывающий области виртуального диска в области, указанной параметрами ByteOffset и ByteLength , которые изменились с момента запечатывания идентификатора отслеживания изменений, указанного параметром ChangeTrackingId .

[in, out] RangeCount

Адрес длинного целого числа без знака. На входных данных значение указывает количество QUERY_CHANGES_VIRTUAL_DISK_RANGE структур, которые может содержать массив, на который указывает параметр Ranges . В выходных данных значение содержит количество QUERY_CHANGES_VIRTUAL_DISK_RANGE структур, помещенных методом в массив.

[out] ProcessedLength

Указатель на длинное целое число без знака, указывающее общее количество байтов, обработанных методом, которое указывает, сколько области, указываемой параметром BytesLength , что изменения были записаны в доступном пространстве массива, заданном параметром Ranges .

Возвращаемое значение

Состояние запроса.

Если функция выполняется успешно, возвращаемое значение ERROR_SUCCESS и параметр Ranges содержит запрошенные сведения.

Если функция завершается сбоем, возвращаемое значение представляет собой код ошибки. Дополнительные сведения см. в разделе Системные коды ошибок.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 [только классические приложения]
Минимальная версия сервера	Windows Server 2016
Целевая платформа	Windows
Header	virtdisk.h
Библиотека	VirtDisk.lib
DLL	VirtDisk.dll

См. также раздел

Сведения о виртуальном жестком диске

QUERY_CHANGES_VIRTUAL_DISK_RANGE

Справочник по виртуальным жестким дискам

Поделиться через