Funzione PdhUpdateLogW (pdh.h)
Raccoglie i dati del contatore per la query corrente e scrive i dati nel file di log.
Sintassi
PDH_FUNCTION PdhUpdateLogW(
[in] PDH_HLOG hLog,
[in] LPCWSTR szUserString
);
Parametri
[in] hLog
Handle di un singolo file di log da aggiornare. La funzione pdhOpenLog
[in] szUserString
Stringa con terminazione Null contenente un commento definito dall'utente da aggiungere al record di dati. La stringa non può essere vuota.
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 |
|---|---|
|
L'handle del file di log non è valido. |
|
È stata passata una stringa vuota nel parametro szUserString. |
Osservazioni
Se si aggiorna un file di log da un altro file di log, i commenti dell'altro file di log non vengono migrati.
Esempi
Per un esempio, vedere Scrittura di dati sulle prestazioni in un file di log.
Nota
L'intestazione pdh.h definisce PdhUpdateLog come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
pdh.h |
| libreria |
Pdh.lib |
| dll | Pdh.dll |