Función ClfsSetLogFileInformation (wdm.h)

Artículo
02/27/2024

La rutina ClfsSetLogFileInformation establece los metadatos y la información de estado de una secuencia especificada y su registro físico subyacente.

Sintaxis

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

Parámetros

[in] plfoLog

Puntero a una estructura LOG_FILE_OBJECT que representa una secuencia CLFS. El autor de la llamada obtuvo previamente este puntero mediante una llamada a ClfsCreateLogFile.

[in] eInformationClass

Valor CLFS_LOG_INFORMATION_CLASS que especifica la clase de información que se establece.

[in] pinfoBuffer

Puntero a un búfer que proporciona la información del registro. La estructura de este búfer varía según la clase de información especificada por eInformationClass. En la tabla siguiente se muestra la relación entre la clase de información y el tipo de búfer.

Valor de eInformationClass	Tipo de búfer al que apunta pinfoBuffer
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

[in] cbBuffer

Tamaño, en bytes, del búfer al que apunta pinfoBuffer.

Valor devuelto

ClfsSetLogFileInformation devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Comentarios

Para obtener una explicación de los conceptos y la terminología de CLFS, consulte Common Log File System.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	wdm.h (incluya Wdm.h)
Library	Clfs.lib
Archivo DLL	Clfs.sys
IRQL	<= APC_LEVEL