Função PdhUpdateLogFileCatalog (pdh.h)

Sincroniza as informações no catálogo de arquivos de log com os dados de desempenho no arquivo de log.

Nota Essa função está obsoleta.

 

Sintaxe

PDH_FUNCTION PdhUpdateLogFileCatalog(
  [in] PDH_HLOG hLog
);

Parâmetros

[in] hLog

Manipule para o arquivo de log que contém o catálogo de arquivos a ser atualizado. A função PdhOpenLog .

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema ou um código de erro PDH. Veja a seguir os valores possíveis.

Código de retorno	Descrição
PDH_NOT_IMPLEMENTED	Um identificador para um arquivo de log CSV ou TSV foi especificado. Esses tipos de arquivo de log não têm catálogos.
PDH_UNKNOWN_LOG_FORMAT	Um identificador para um arquivo de log com um formato desconhecido foi especificado.
PDH_INVALID_HANDLE	O identificador não é válido.

Comentários

O catálogo de arquivos de log serve como um índice para os registros de dados de desempenho no arquivo de log, fornecendo pesquisas mais rápidas para registros individuais no arquivo.

Os catálogos devem ser atualizados quando o processo de coleta de dados for concluído e o arquivo de log tiver sido fechado. O catálogo pode ser atualizado durante a coleta de dados, mas isso pode interromper o processo de registro em log dos dados de desempenho porque a atualização dos catálogos pode ser demorada.

Os arquivos de log Perfmon, CSV e TSV não têm catálogos. Especificar um identificador para esses tipos de arquivo de log resultará em um valor retornado de PDH_NOT_IMPLEMENTED.

Requisitos

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

Confira também

PdhGetLogFileSize

PdhUpdateLog