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

Confira também

Sobre o VHD

QUERY_CHANGES_VIRTUAL_DISK_RANGE

Referência de VHD