Compartilhar via


Função GetLogIoStatistics (clfsw32.h)

Recupera estatísticas de E/S de log para um log dedicado ou multiplexado associado ao identificador especificado. Essa função consulta o CLFS (Common Log File System) para tipos específicos de estatísticas de E/S de log. Chamar essa função em um log multiplexado associa apenas as estatísticas ao log subjacente.

Sintaxe

CLFSUSER_API BOOL GetLogIoStatistics(
  [in]            HANDLE             hLog,
  [in, out]       PVOID              pvStatsBuffer,
  [in]            ULONG              cbStatsBuffer,
  [in]            CLFS_IOSTATS_CLASS eStatsClass,
  [out, optional] PULONG             pcbStatsWritten
);

Parâmetros

[in] hLog

Um identificador para um arquivo de log aberto que CreateLogFile obtém. O identificador de log pode se referir a um arquivo de log dedicado ou multiplexado.

[in, out] pvStatsBuffer

Um ponteiro para um buffer para receber as estatísticas de E/S.

Esse buffer deve ser pelo menos tão grande quanto um cabeçalho de pacote de estatísticas de E/S. Para obter mais informações, consulte CLFS_IO_STATISTICS_HEADER.

[in] cbStatsBuffer

O tamanho do buffer de estatísticas de E/S pvStatsBuffer, em bytes.

Se o buffer não for grande o suficiente para o pacote de estatísticas, a função falhará com ERROR_MORE_DATA.

[in] eStatsClass

Esse parâmetro não é implementado no momento; ele é reservado para uso futuro.

[out, optional] pcbStatsWritten

Um ponteiro para uma variável para receber o tamanho do pacote de estatísticas de E/S gravado no pvStatsBuffer.

Esse valor é menor ou igual a cbStatsBuffer.

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á 0 (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_IOSTATS_CLASS

CLFS_IO_STATISTICS_HEADER

Funções comuns do sistema de arquivos de log