Función QueryChangesVirtualDisk (virtdisk.h)
Recupera información sobre los cambios realizados en las áreas especificadas de un disco duro virtual (VHD) del que se realiza el seguimiento de cambios resistente (RCT).
Sintaxis
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
);
Parámetros
[in] VirtualDiskHandle
Identificador del VHD abierto, que debe haberse abierto con la marca VIRTUAL_DISK_ACCESS_GET_INFO establecida en el parámetro VirtualDiskAccessMask en la función OpenVirtualDisk . Para obtener información sobre cómo abrir un disco duro virtual, consulte la función OpenVirtualDisk .
[in] ChangeTrackingId
Puntero a una cadena que especifica el identificador de seguimiento de cambios para el cambio que identifica el estado del disco virtual que desea usar como base de comparación para determinar si el área especificada del disco duro virtual ha cambiado.
[in] ByteOffset
Entero largo sin signo que especifica la distancia desde el inicio del disco duro virtual hasta el principio del área del VHD que desea comprobar si hay cambios, en bytes.
[in] ByteLength
Entero largo sin signo que especifica la longitud del área del disco duro virtual que desea comprobar si hay cambios, en bytes.
[in] Flags
Reservado. Establézcalo en QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE.
[out] Ranges
Matriz de estructuras de QUERY_CHANGES_VIRTUAL_DISK_RANGE que indica las áreas del disco virtual dentro del área en la que los parámetros ByteOffset y ByteLength especifican que han cambiado desde el identificador de seguimiento de cambios que especifica el parámetro ChangeTrackingId .
[in, out] RangeCount
Dirección de un entero largo sin signo. En la entrada, el valor indica el número de estructuras de QUERY_CHANGES_VIRTUAL_DISK_RANGE que la matriz a la que apunta el parámetro Ranges puede contener. En la salida, el valor contiene el número de estructuras de QUERY_CHANGES_VIRTUAL_DISK_RANGE que el método colocó en la matriz.
[out] ProcessedLength
Puntero a un entero largo sin signo que indica el número total de bytes procesados por el método, que indica la cantidad del área que el parámetro BytesLength especifica que los cambios se capturaron en el espacio disponible de la matriz que especifica el parámetro Ranges .
Valor devuelto
Estado de la solicitud.
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS y el parámetro Ranges contiene la información solicitada.
Si se produce un error en la función, el valor devuelto es un código de error. Para obtener más información, vea Códigos de error del sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 |
| Plataforma de destino | Windows |
| Encabezado | virtdisk.h |
| Library | VirtDisk.lib |
| Archivo DLL | VirtDisk.dll |