FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)
Recupera o conjunto de registros de diário de alteração usn (número de sequência de atualização) entre dois valores de USN especificados.
C++ |
---|
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume (DWORD) FSCTL_READ_USN_JOURNAL, // 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
Para obter as implicações da E/S sobreposta nesta operação, consulte a seção Comentários do tópico DeviceIoControl.
Há dois códigos de controle DeviceIoControl que retornam registros USN, FSCTL_READ_USN_JOURNAL e FSCTL_ENUM_USN_DATA. Use este último quando desejar uma listagem (enumeração) dos registros USN entre dois USNs. Use o primeiro quando desejar selecionar pela USN.
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 NTFS.
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) | Consulte o comentário |
Um aplicativo pode experimentar falsos positivos na pausa/retomada de CsvFs.
Exemplos
Para obter um exemplo, consulte um buffer de registros de diário de alteração.
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) |