Funzione QueryChangesVirtualDisk (virtdisk.h)

Articolo
03/03/2024

Recupera informazioni sulle modifiche apportate alle aree specificate di un disco rigido virtuale (VHD) monitorato dal rilevamento delle modifiche resiliente (RCT).

Sintassi

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

Parametri

[in] VirtualDiskHandle

Handle per il disco rigido virtuale aperto, che deve essere stato aperto usando il flag VIRTUAL_DISK_ACCESS_GET_INFO impostato nel parametro VirtualDiskAccessMask alla funzione OpenVirtualDisk . Per informazioni su come aprire un disco rigido virtuale, vedere la funzione OpenVirtualDisk .

[in] ChangeTrackingId

Puntatore a una stringa che specifica l'identificatore di rilevamento delle modifiche per la modifica che identifica lo stato del disco virtuale che si vuole usare come base di confronto per determinare se l'area specificata del disco rigido virtuale è stata modificata.

[in] ByteOffset

Intero lungo senza segno che specifica la distanza dall'inizio del disco rigido virtuale all'inizio dell'area del disco rigido virtuale da controllare per le modifiche, in byte.

[in] ByteLength

Intero lungo senza segno che specifica la lunghezza dell'area del disco rigido virtuale da controllare per le modifiche, in byte.

[in] Flags

Riservato. Impostare su QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE.

[out] Ranges

Matrice di strutture QUERY_CHANGES_VIRTUAL_DISK_RANGE che indica le aree del disco virtuale all'interno dell'area in cui i parametri ByteOffset e ByteLength specificano che sono stati modificati dall'identificatore di rilevamento delle modifiche specificato dal parametro ChangeTrackingId .

[in, out] RangeCount

Indirizzo di un intero lungo senza segno. In input, il valore indica il numero di strutture QUERY_CHANGES_VIRTUAL_DISK_RANGE che la matrice a cui punta il parametro Range . Nell'output il valore contiene il numero di strutture QUERY_CHANGES_VIRTUAL_DISK_RANGE che il metodo inserito nella matrice.

[out] ProcessedLength

Puntatore a un intero lungo senza segno che indica il numero totale di byte elaborati dal metodo, che indica per la quantità di area specificata dal parametro BytesLength che specifica che le modifiche sono state acquisite nello spazio disponibile della matrice specificata dal parametro Range .

Valore restituito

Lo stato della richiesta.

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS e il parametro Range contiene le informazioni richieste.

Se la funzione ha esito negativo, il valore restituito è un codice di errore. Per altre informazioni, vedere Codici di errore di sistema.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 [solo app desktop]
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Intestazione	virtdisk.h
Libreria	VirtDisk.lib
DLL	VirtDisk.dll

Vedi anche

Informazioni sul disco rigido virtuale

QUERY_CHANGES_VIRTUAL_DISK_RANGE

Informazioni di riferimento sul disco rigido virtuale

Condividi tramite