FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

Recupera as informações de diário de alteração de número de sequência de atualização (USN) para o arquivo ou diretório especificado.

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

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                 (DWORD) FSCTL_READ_FILE_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

Observações

Se a chamada for bem-sucedida, os membros da estrutura de USN_RECORD_V2 ou USN_RECORD_V3 retornados serão válidos, exceto para os seguintes membros: TimeStamp, Reasone SourceInfo. O membro usn representa o último USN escrito no diário para este arquivo ou diretório.

Para obter mais informações, consulte Criando, modificando e excluindo um diário de alterações.

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 aparece. O volume deve ser ReFS ou 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.exe FSInfo NTFSInfo X:

em que X é a letra da unidade do volume.

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

Requisitos

Consulte também

CreateFile

DeviceIoControl

USN_RECORD

códigos de controle de gerenciamento de volume