Funzione ClfsQueryLogFileInformation (wdm.h)

Articolo
08/08/2023

La routine ClfsQueryLogFileInformation restituisce metadati e informazioni sullo stato per un flusso CLFS specificato o per il log fisico sottostante o entrambi.

Sintassi

CLFSUSER_API NTSTATUS ClfsQueryLogFileInformation(
  [in]  PLOG_FILE_OBJECT           plfoLog,
  [in]  CLFS_LOG_INFORMATION_CLASS eInformationClass,
        PVOID                      pinfoInputBuffer,
        ULONG                      cbinfoInputBuffer,
  [out] PVOID                      pinfoBuffer,
        PULONG                     pcbInfoBuffer
);

Parametri

[in] plfoLog

Puntatore a una struttura LOG_FILE_OBJECT che rappresenta un flusso CLFS. Il chiamante ha ottenuto in precedenza questo puntatore chiamando ClfsCreateLogFile.

[in] eInformationClass

Valore dell'enumerazione CLFS_LOG_INFORMATION_CLASS che specifica il tipo di informazioni richieste.

pinfoInputBuffer

Buffer di input facoltativo necessario per alcune classi di informazioni.

cbinfoInputBuffer

Lunghezza in byte di pinfoInputBuffer.

[out] pinfoBuffer

Puntatore a un buffer che riceve le informazioni del log. La struttura di questo buffer dipende dal valore di eInformationClass. Nella tabella seguente viene illustrata la relazione tra la classe di informazioni e il tipo di dati del buffer.

Valore di eInformationClass	Tipo di buffer a cui punta pinfoBuffer
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

pcbInfoBuffer

Lunghezza in byte del buffer delle informazioni in ingresso.

Valore restituito

ClfsQueryLogFileInformation restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

Per una spiegazione dei concetti e della terminologia di CLFS, vedere Common Log File System.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Server 2003 R2, Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Vedi anche

ClfsSetLogFileInformation

Condividi tramite