Compartilhar via

FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • Artigo

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.

C++ 
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.

Tecnologia Suportado
Protocolo SMB (Bloco de Mensagens do Servidor) 3.0 Não
TFO (Failover Transparente) do SMB 3.0 Não
SMB 3.0 com Compartilhamentos de Arquivos de Expansão (SO) Não
Sistema de Arquivos de Volume Compartilhado de Cluster (CsvFS) Sim

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho winioctl.h (inclua Windows.h)

Consulte também

CreateFile

DeviceIoControl

USN_RECORD

códigos de controle de gerenciamento de volume