Função QueryChangesVirtualDisk (virtdisk.h)
Recupera informações sobre alterações nas áreas especificadas de um VHD (disco rígido virtual) que são controladas pelo RCT (controle de alterações resiliente).
Sintaxe
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
Um identificador para o VHD aberto, que deve ter sido aberto usando o sinalizador VIRTUAL_DISK_ACCESS_GET_INFO definido no parâmetro VirtualDiskAccessMask para a função OpenVirtualDisk . Para obter informações sobre como abrir um VHD, consulte a função OpenVirtualDisk .
[in] ChangeTrackingId
Um ponteiro para uma cadeia de caracteres que especifica o identificador de controle de alterações para a alteração que identifica o estado do disco virtual que você deseja usar como base de comparação para determinar se a área especificada do VHD foi alterada.
[in] ByteOffset
Um inteiro longo sem sinal que especifica a distância do início do VHD até o início da área do VHD que você deseja marcar para alterações, em bytes.
[in] ByteLength
Um inteiro longo sem sinal que especifica o comprimento da área do VHD que você deseja marcar para alterações, em bytes.
[in] Flags
Reservado. Defina como QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE.
[out] Ranges
Uma matriz de estruturas QUERY_CHANGES_VIRTUAL_DISK_RANGE que indica as áreas do disco virtual dentro da área que os parâmetros ByteOffset e ByteLength especificam que foram alteradas desde que o identificador de controle de alterações especificado pelo parâmetro ChangeTrackingId foi selado.
[in, out] RangeCount
Um endereço de um inteiro longo sem sinal. Na entrada, o valor indica o número de estruturas de QUERY_CHANGES_VIRTUAL_DISK_RANGE que a matriz para a qual o parâmetro Ranges aponta pode conter. Na saída, o valor contém o número de estruturas QUERY_CHANGES_VIRTUAL_DISK_RANGE que o método colocou na matriz.
[out] ProcessedLength
Um ponteiro para um inteiro longo sem sinal que indica o número total de bytes processados pelo método, o que indica quanto da área que o parâmetro BytesLength especifica que as alterações foram capturadas no espaço disponível da matriz especificada pelo parâmetro Ranges .
Retornar valor
O status da solicitação.
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS e o parâmetro Ranges conterá as informações solicitadas.
Se a função falhar, o valor retornado será um código de erro. Para obter mais informações, consulte Códigos de erro do sistema.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 |
| Plataforma de Destino | Windows |
| Cabeçalho | virtdisk.h |
| Biblioteca | VirtDisk.lib |
| DLL | VirtDisk.dll |