FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

Habilita o controle de intervalo para o fluxo de diário de alteração de número de sequência de atualização (USN) 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 mais detalhes sobre as implicações de E/S sobrepostas nesta operação, consulte as observações de DeviceIoControl.

FSCTL_USN_TRACK_MODIFIED_RANGES pode ser usado para habilitar o controle de intervalo pela primeira vez em um volume. Depois de habilitar o controle de intervalo, o estado e os parâmetros serão mantidos para esse volume (na reinicialização, o controle de intervalo será inicializado a partir dos parâmetros persistentes).

FSCTL_USN_TRACK_MODIFIED_RANGES também pode ser usado 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. Uma vez 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 os direitos de acesso do Administrador e execute o seguinte comando (em que X é a letra da unidade do volume): fsutil fsinfo ntfsinfo X:

Irp-IoStatus.Status> será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, Status será definido como a condição de erro apropriada como um código NTSTATUS. Para obter mais informações, consulte valores NTSTATUS.

Requisitos

Consulte também

• DeviceIoControl