FSCTL_ENUM_USN_DATA IOCTL (winioctl.h)
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) |