Compartilhar via

FSCTL_WRITE_USN_CLOSE_RECORD IOCTL (winioctl.h)

  • Artigo

Gera um registro no fluxo de diário de alteração usn (número de sequência de atualização) para o arquivo de entrada. Esse registro terá o sinalizador USN_REASON_CLOSE.

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

C++ 
BOOL 
WINAPI
DeviceIoControl( (HANDLE) hDevice,              // handle to volume
                 FSCTL_WRITE_USN_CLOSE_RECORD,  // dwIoControlCodeNULL,                          // lpInBuffer0,                             // nInBufferSize(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 para DeviceIoControl.

Você pode usar FSCTL_WRITE_USN_CLOSE_RECORD para forçar um registro de fechamento no diário de alteração do identificador de entrada. O registro de fechamento também conterá quaisquer motivos atuais de USN para esse arquivo. O buffer de saída retornará o valor USN associado a essa operação.

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 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
 

operações transacionadas

Se FSCTL_WRITE_USN_CLOSE_RECORD for chamado com um identificador bloqueado por uma transação, ele sempre falhará.

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

alterar diários

CreateFile

DeviceIoControl

SOBREPOSTOS

códigos de controle de gerenciamento de volume