Compartilhar via

FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

  • Artigo

Habilita o recurso de controle de intervalo para fluxo de diário de alteração usn (número de sequência de atualização) em um volume de destino ou modifica parâmetros de acompanhamento de intervalo já habilitados.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to volume
  FSCTL_USN_TRACK_MODIFIED_RANGES,  // dwIoControlCode
  (LPDWORD) lpInBuffer,             // input buffer
  (DWORD) nInBufferSize,            // size of input buffer
  (LPDWORD) lpOutBuffer,            // lpOutbuffer
  (DWORD) nOutBufferSize,           // size of output buffer
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

Observações

Para obter as implicações da E/S sobreposta nesta operação, consulte a seção Comentários do tópico DeviceIoControl.

Você pode usar FSCTL_USN_TRACK_MODIFIED_RANGES para habilitar o controle de intervalo pela primeira vez para um volume. Após o controle de intervalo de habilitação, o estado e os parâmetros serão persistidos para esse volume e, na próxima reinicialização, o controle de intervalo será inicializado lido dos parâmetros persistentes.

Você também pode usar FSCTL_USN_TRACK_MODIFIED_RANGES para modificar um parâmetro de faixa de fluxo de fluxo de diário de alteração existente. Se o controle de intervalo já existir, FSCTL_USN_TRACK_MODIFIED_RANGES defini-lo para os parâmetros fornecidos na estrutura de USN_TRACK_MODIFIED_RANGES. O tamanho da parte ou o limite de tamanho do arquivo só pode ser reduzido dos valores anteriores. Depois de habilitado, o recurso de controle de intervalo não pode ser desabilitado, a menos que o diário seja excluído.

Para recuperar um identificador para um volume, chame CreateFile com o parâmetro lpFileName definido como uma cadeia de caracteres no seguinte formulário:

\\.\X:

Na cadeia de caracteres anterior, X é a letra que identifica a unidade na qual o volume é exibido. O volume deve ser NTFS 3.0 ou posterior. Para obter a versão NTFS de um volume, abra um prompt de comando com direitos de acesso do Administrador e execute o seguinte comando:

fsutil fsinfo ntfsinfoX:

em que X é a letra da unidade do volume.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8.1 [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2012 R2 [somente aplicativos da área de trabalho]
cabeçalho winioctl.h (inclua Windows.h)

Consulte também

  • DeviceIoControl