Compartilhar via


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)

Consulte também

CREATE_USN_JOURNAL_DATA

alterar diários

CreateFile

DeviceIoControl

SOBREPOSTOS

códigos de controle de gerenciamento de volume