Funzione PdhUpdateLogFileCatalog (pdh.h)
Sincronizza le informazioni nel catalogo dei file di log con i dati sulle prestazioni nel file di log.
Sintassi
PDH_FUNCTION PdhUpdateLogFileCatalog(
[in] PDH_HLOG hLog
);
Parametri
[in] hLog
Gestire il file di log contenente il catalogo file da aggiornare. Funzione PdhOpenLog .
Valore restituito
Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema o un codice di errore PDH. Di seguito sono riportati i valori possibili.
| Codice restituito | Descrizione |
|---|---|
|
È stato specificato un handle in un file di log CSV o TSV. Questi tipi di file di log non dispongono di cataloghi. |
|
È stato specificato un handle per un file di log con un formato sconosciuto. |
|
L'handle non è valido. |
Commenti
Il catalogo dei file di log funge da indice per i record dei dati delle prestazioni nel file di log, fornendo ricerche più veloci per singoli record nel file.
I cataloghi devono essere aggiornati al termine del processo di raccolta dati e il file di log è stato chiuso. Il catalogo può essere aggiornato durante la raccolta dati, ma in questo modo può interrompere il processo di registrazione dei dati sulle prestazioni perché l'aggiornamento dei cataloghi può richiedere molto tempo.
I file di log perfmon, CSV e TSV non dispongono di cataloghi. Se si specifica un handle per questi tipi di file di log, verrà restituito un valore restituito di PDH_NOT_IMPLEMENTED.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | pdh.h |
| Libreria | Pdh.lib |
| DLL | Pdh.dll |