FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

  • Artigo

Habilita o recurso de rastreamento de intervalo para fluxo do diário de alterações de USN (números de sequência de atualização) em um volume de destino ou modifica parâmetros de rastreamento 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
);

Comentários

Para obter as implicações de 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 rastreamento de intervalos 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 rastreamento 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 diário de alterações existente. Se o rastreamento de intervalo já existir, FSCTL_USN_TRACK_MODIFIED_RANGES o definirá como os parâmetros fornecidos na estrutura 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 rastreamento 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 formato:

\\.\X:

Na cadeia de caracteres anterior, X é a letra que identifica a unidade na qual o volume aparece. 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:

sendo que X é a letra da unidade do volume.

Requisitos

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

Confira também