Funzione PdhVbOpenLog
La funzione PdhVbOpenLog apre il file di log specificato per la lettura e la scrittura. Questa funzione chiama PdhOpenLog.
Importante
La funzione descritta in questo argomento può essere modificata o non disponibile in futuro. Microsoft consiglia invece di usare le funzioni descritte in Funzioni contatori delle prestazioni.
Function PdhVbOpenLog( _ ByVal szLogFileName As LPCTSTR, _ ByVal dwAccessFlags As DWORD, _ ByVal lpdwLogType As LPDWORD, _ ByVal hQuery As PDH_HQUERY, _ ByVal dwMaxSize As DWORD, _ ByVal szUserCaption As LPCSTR, _ ByRef phLog As PDH_HLOG _ ) As DWORD
Parametri
-
szLogFileName [in]
-
Puntatore a una stringa che specifica il nome del file di log da aprire.
Se il file di log contiene dati SQL, il formato del nome del file di log è **SQL:DataSourceName!**LogFileName. In questo caso, il valore del parametro lpdwLogType è PDH_LOG_TYPE_SQL.
-
dwAccessFlags [in]
-
Tipo di accesso da specificare quando viene aperto il file di log. Questo parametro può avere uno dei valori seguenti.
Valore Significato - PDH_LOG_READ_ACCESS
Viene aperto un file di log per un'operazione di lettura. - PDH_LOG_WRITE_ACCESS
Viene aperto un nuovo file di log per un'operazione di scrittura. - PDH_LOG_UPDATE_ACCESS
Un file di log esistente viene aperto per un'operazione di scrittura. Il valore selezionato dalla tabella precedente può essere combinato usando l'operatore OR con uno dei flag di accesso seguenti.
Valore Significato - PDH_LOG_CREATE_NEW
Viene creato un nuovo file di log con il nome specificato. - PDH_LOG_CREATE_ALWAYS
Viene creato un nuovo file di log con il nome specificato e viene cancellato qualsiasi file di log esistente con lo stesso nome. - PDH_LOG_OPEN_EXISTING
Viene aperto un file di log esistente con il nome specificato. Se non esiste un file di log con il nome specificato, questo è uguale a PDH_LOG_CREATE_NEW. - PDH_LOG_OPEN_ALWAYS
Viene aperto un file di log esistente con il nome specificato o viene creato un nuovo file di log con il nome specificato. -
lpdwLogType [in]
-
Puntatore a una variabile che indica il tipo di file di log da aprire. Questo parametro può avere uno dei valori seguenti.
Valore Significato - PDH_LOG_TYPE_UNDEFINED
Formato di file di log non definito. - PDH_LOG_TYPE_CSV
File di testo contenenti intestazioni di colonna nella prima riga e singoli esempi di dati in ogni riga successiva. - PDH_LOG_TYPE_SQL
I dati nel file di log sono in SQL. - PDH_LOG_TYPE_TSV
Uguale a PDH_LOG_TYPE_CSV. - PDH_LOG_TYPE_BINARY
Formato file di log binario. Include file di log circolari. - PDH_LOG_TYPE_PERFMON
Formato di file di log perfmon. -
hQuery [in]
-
Handle di query. Questo handle viene restituito dalla funzione PdhVbOpenQuery .
Questo parametro può essere NULL se il file di log deve essere aperto per la lettura.
-
dwMaxSize [in]
-
Dimensioni massime del file di log, in byte. Questo valore viene usato solo se il file di log è un file di log di dimensioni limitate o circolari.
-
szUserCaption [in]
-
Puntatore a una stringa che specifica il didascalia definito dall'utente del file di log. Un file di log didascalia descrive in genere il contenuto del file di log. Quando viene aperto un file di log esistente, il valore di questo parametro viene ignorato.
-
phLog [in, ref]
-
Puntatore a un buffer che riceve un handle al file di log aperto.
Valore restituito
Se la funzione ha esito positivo, restituisce 0.
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 |
|---|---|
|
I dati richiesti sono maggiori del buffer fornito. Impossibile restituire i dati richiesti. |
|
Uno o più buffer di stringa non sono le dimensioni corrette. |
|
L'handle non è un oggetto PDH valido. |
|
Impossibile aprire il file di log specificato. |
|
Impossibile trovare il file specificato. |
Commenti
Quando si usa questa funzione per scrivere dati sulle prestazioni in un file di log, è prima necessario aprire una query usando PdhVbOpenQuery.
È necessario aprire una query e i contatori desiderati devono essere aggiunti prima che questa funzione venga chiamata.
Si noti che i file di log nel formato Perfmon possono essere aperti solo per la lettura.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| Libreria |
|
| DLL |
|