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.
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 |
|---|---|
|
Um identificador para um arquivo de log CSV ou TSV foi especificado. Esses tipos de arquivo de log não têm catálogos. |
|
Um identificador para um arquivo de log com um formato desconhecido foi especificado. |
|
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 |