Fonction QueryChangesVirtualDisk (virtdisk.h)

Récupère des informations sur les modifications apportées aux zones spécifiées d’un disque dur virtuel (VHD) qui sont suivies par le suivi des modifications résilient (RCT).

Syntaxe

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
);

Paramètres

[in] VirtualDiskHandle

Handle du disque dur virtuel ouvert, qui doit avoir été ouvert à l’aide de l’indicateur VIRTUAL_DISK_ACCESS_GET_INFO défini dans le paramètre VirtualDiskAccessMask sur la fonction OpenVirtualDisk . Pour plus d’informations sur l’ouverture d’un disque dur virtuel, consultez la fonction OpenVirtualDisk .

[in] ChangeTrackingId

Pointeur vers une chaîne qui spécifie l’identificateur de suivi des modifications pour la modification qui identifie l’état du disque virtuel que vous souhaitez utiliser comme base de comparaison pour déterminer si la zone spécifiée du disque dur virtuel a changé.

[in] ByteOffset

Entier long non signé qui spécifie la distance entre le début du disque dur virtuel et le début de la zone du disque dur virtuel que vous souhaitez case activée pour les modifications, en octets.

[in] ByteLength

Entier long non signé qui spécifie la longueur de la zone du disque dur virtuel que vous souhaitez case activée pour les modifications, en octets.

[in] Flags

Réservé. Définissez sur QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE.

[out] Ranges

Tableau de structures QUERY_CHANGES_VIRTUAL_DISK_RANGE qui indique les zones du disque virtuel dans la zone que les paramètres ByteOffset et ByteLength spécifient qui ont changé depuis que l’identificateur de suivi des modifications spécifié par le paramètre ChangeTrackingId a été scellé.

[in, out] RangeCount

Adresse d’un entier long non signé. Lors de l’entrée, la valeur indique le nombre de structures QUERY_CHANGES_VIRTUAL_DISK_RANGE que le tableau vers lequel le paramètre Ranges pointe peut contenir. En sortie, la valeur contient le nombre de structures QUERY_CHANGES_VIRTUAL_DISK_RANGE que la méthode a placées dans le tableau.

[out] ProcessedLength

Pointeur vers un entier long non signé qui indique le nombre total d’octets traités par la méthode, qui indique la quantité de la zone dans laquelle le paramètre BytesLength spécifie que les modifications ont été capturées dans l’espace disponible du tableau spécifié par le paramètre Ranges .

Valeur retournée

État de la demande.

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS et le paramètre Ranges contient les informations demandées .

Si la fonction échoue, la valeur de retour est un code d’erreur. Pour plus d’informations, consultez Codes d’erreur système.

Configuration requise

Voir aussi

À propos du disque dur virtuel

QUERY_CHANGES_VIRTUAL_DISK_RANGE

Référence du disque dur virtuel