Compartir a través de

Función ClfsQueryLogFileInformation (wdm.h)

  • Artículo

La rutina ClfsQueryLogFileInformation devuelve metadatos e información de estado de una secuencia CLFS especificada o su registro físico subyacente o ambos.

Sintaxis

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

Parámetros

[in] plfoLog

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

[in] eInformationClass

Valor de la enumeración CLFS_LOG_INFORMATION_CLASS que especifica el tipo de información que se solicita.

pinfoInputBuffer

Búfer de entrada opcional que es necesario para algunas clases de información.

cbinfoInputBuffer

Longitud en bytes de pinfoInputBuffer.

[out] pinfoBuffer

Puntero a un búfer que recibe la información de registro. La estructura de este búfer depende del valor de eInformationClass. En la tabla siguiente se muestra la relación entre la clase de información y el tipo de datos del 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

pcbInfoBuffer

Longitud en bytes del búfer de información entrante.

Valor devuelto

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

Observaciones

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

Requisitos

Requisito Valor
cliente mínimo admitido Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows.
de la plataforma de destino de Escritorio
encabezado de wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de Clfs.lib
DLL de Clfs.sys
irQL <= APC_LEVEL

Consulte también

ClfsSetLogLogFileInformation