Função GetLogFileInformation (clfsw32.h)
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 |