FSCTL_CREATE_USN_JOURNAL IOCTL (winioctl.h)
Cria um fluxo de diário de alteração usn (número de sequência de atualização) em um volume de destino ou modifica um fluxo de diário de alterações existente.
| C++ |
|---|
BOOL
WINAPI
DeviceIoControl( (HANDLE) hDevice, // handle to volume
FSCTL_CREATE_USN_JOURNAL, // dwIoControlCode(LPVOID) lpInBuffer, // input buffer
(DWORD) nInBufferSize, // size of input buffer
NULL, // lpOutBuffer
0, // nOutBufferSize(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.
Você pode usar FSCTL_CREATE_USN_JOURNAL para criar um novo fluxo de diário de alterações para um volume. Após a criação do fluxo, o sistema de arquivos NTFS mantém um diário de alterações para esse volume.
Você também pode usar FSCTL_CREATE_USN_JOURNAL para modificar um fluxo de diário de alterações existente. Se já existir um fluxo de diário de alteração, FSCTL_CREATE_USN_JOURNAL o definirá como as características fornecidas na estrutura de CREATE_USN_JOURNAL_DATA. O fluxo de diário de alteração eventualmente fica maior ou é cortado para o novo limite de tamanho que CREATE_USN_JOURNAL_DATA impõe.
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 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 fsinfo ntfsinfo X:
em que X é a letra da unidade do volume.
No Windows Server 2012, essa função é 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) |