FSCTL_ENUM_USN_DATA IOCTL (winioctl.h)

  • Artigo

Enumera os dados de USN (número de sequência de atualização) entre dois limites especificados para obter master registros de tabela de arquivos (MFT).

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

C++ 
BOOL 
WINAPI 
DeviceIoControl( (HANDLE) hDevice,              // handle to volume
                 (DWORD) FSCTL_ENUM_USN_DATA,   // dwIoControlCode(LPVOID) lpInBuffer,           // input buffer
                 (DWORD) nInBufferSize,         // size of input buffer
                 (LPVOID) lpOutBuffer,          // output buffer
                 (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 .

Para enumerar arquivos em um volume, use a operação FSCTL_ENUM_USN_DATA uma ou mais vezes. Na primeira chamada, defina o ponto de partida, o membro StartFileReferenceNumber da estrutura MFT_ENUM_DATA , como (DWORDLONG)0. Cada chamada para FSCTL_ENUM_USN_DATA recupera o ponto de partida para a chamada subsequente como a primeira entrada no buffer de saída.

Comparando Para identificar alterações recentes em um volume, use o código de controle FSCTL_READ_USN_JOURNAL .

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.

Em Windows 8 e Windows Server 2012, esse código é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB 3.0 Não
TFO (Failover Transparente) do SMB 3.0 No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) Não
CsvFS (Sistema de Arquivos de Volume Compartilhado clusterizado) Sim

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

CreateFile

Deviceiocontrol

FSCTL_READ_USN_JOURNAL

GetOverlappedResult

MFT_ENUM_DATA

SOBREPOSTA

USN_RECORD

Códigos de controle de gerenciamento de volume