Función ClfsQueryLogFileInformation (wdm.h)

  • Artículo

La rutina ClfsQueryLogFileInformation devuelve metadatos e información de estado para 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 de LOG_FILE_OBJECT que representa una secuencia CLFS. El autor de la llamada obtuvo 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 del 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.

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, Ntddk.h, Ntifs.h)
Library Clfs.lib
Archivo DLL Clfs.sys
IRQL <= APC_LEVEL

Consulte también

ClfsSetLogFileInformation