Funzione GetLogIoStatistics (clfsw32.h)

Recupera le statistiche di I/O del log per un log dedicato o multiplexed associato all'handle specificato. Questa funzione esegue query su Common Log File System (CLFS) per tipi specifici di statistiche di I/O del log. La chiamata a questa funzione in un log multiplexed associa solo le statistiche al log sottostante.

Sintassi

CLFSUSER_API BOOL GetLogIoStatistics(
  [in]            HANDLE             hLog,
  [in, out]       PVOID              pvStatsBuffer,
  [in]            ULONG              cbStatsBuffer,
  [in]            CLFS_IOSTATS_CLASS eStatsClass,
  [out, optional] PULONG             pcbStatsWritten
);

Parametri

[in] hLog

Handle per un file di log aperto che CreaLogFile ottiene. L'handle di log può fare riferimento a un file di log dedicato o multiplexed.

[in, out] pvStatsBuffer

Puntatore a un buffer per ricevere le statistiche di I/O.

Questo buffer deve essere almeno di grandi dimensioni come un'intestazione del pacchetto di statistiche di I/O. Per altre informazioni, vedere CLFS_IO_STATISTICS_HEADER.

[in] cbStatsBuffer

Dimensioni del buffer delle statistiche di I/O pvStatsBuffer, in byte.

Se il buffer non è sufficiente per il pacchetto di statistiche, la funzione ha esito negativo con ERROR_MORE_DATA.

[in] eStatsClass

Questo parametro non viene implementato in questo momento; è riservato per l'uso futuro.

[out, optional] pcbStatsWritten

Puntatore a una variabile per ricevere le dimensioni del pacchetto di statistiche di I/O scritto in pvStatsBuffer.

Questo valore è minore o uguale a cbStatsBuffer.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero (0). Per informazioni dettagliate sull'errore, chiamare GetLastError. L'elenco seguente identifica i possibili codici di errore:

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione clfsw32.h
Libreria Clfsw32.lib
DLL Clfsw32.dll

Vedi anche

CLFS_IOSTATS_CLASS

CLFS_IO_STATISTICS_HEADER

Funzioni comuni del file system di log