Função GetLogFileInformation (clfsw32.h)

  • Artigo

Retorna um buffer que contém metadados sobre um log especificado e seu estado atual, que é definido pela estrutura CLFS_INFORMATION .

Os dados obtidos refletem o estado do log somente no momento em que a chamada é feita. Normalmente, um cliente pode continuar armazenando em cache e usando campos dessa estrutura até a próxima vez que ele anexar registros ou gravar sua área de reinicialização. Nesse momento, algumas das informações se tornam obsoletas.

Sintaxe

CLFSUSER_API BOOL GetLogFileInformation(
  [in]      HANDLE            hLog,
  [in, out] PCLFS_INFORMATION pinfoBuffer,
  [in, out] PULONG            cbBuffer
);

Parâmetros

[in] hLog

Um identificador para um log aberto obtido de uma chamada bem-sucedida para CreateLogFile.

O identificador de log pode se referir a um log dedicado ou multiplexado.

[in, out] pinfoBuffer

Um ponteiro para uma estrutura de CLFS_INFORMATION alocada pelo usuário que recebe os metadados de log.

[in, out] cbBuffer

Um ponteiro para uma variável que na entrada especifica o tamanho, em bytes, do buffer de metadados apontado por pinfoBuffer.

Na saída, ele especifica o número de bytes que são realmente copiados para pinfoBuffer.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

A lista a seguir identifica os possíveis códigos de erro:

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho clfsw32.h
Biblioteca Clfsw32.lib
DLL Clfsw32.dll

Confira também

CLFS_INFORMATION

Funções comuns do sistema de arquivos de log

CreateLogFile

Obtendo o próximo LSN