Funzione ClfsSetLogFileInformation (wdm.h)

Articolo
03/08/2023

La routine ClfsSetLogFileInformation imposta metadati e informazioni sullo stato per un flusso specificato e il relativo log fisico sottostante.

Sintassi

CLFSUSER_API NTSTATUS ClfsSetLogFileInformation(
  [in] PLOG_FILE_OBJECT           plfoLog,
  [in] CLFS_LOG_INFORMATION_CLASS eInformationClass,
  [in] PVOID                      pinfoBuffer,
  [in] ULONG                      cbBuffer
);

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 CLFS_LOG_INFORMATION_CLASS che specifica la classe di informazioni impostate.

[in] pinfoBuffer

Puntatore a un buffer che fornisce le informazioni del log. La struttura di questo buffer varia in base alla classe di informazioni specificate da eInformationClass. Nella tabella seguente viene illustrata la relazione tra la classe di informazioni e il tipo di buffer.

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

[in] cbBuffer

Dimensioni, in byte, del buffer a cui fa riferimento pinfoBuffer.

Valore restituito

ClfsSetLogFileInformation 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 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)
Libreria	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL