Función GetLogFileInformation (clfsw32.h)

  • Artículo

Devuelve un búfer que contiene metadatos sobre un registro especificado y su estado actual, que se define mediante la estructura CLFS_INFORMATION .

Los datos obtenidos reflejan el estado del registro solo en el momento en que se realiza la llamada. Normalmente, un cliente puede seguir almacenando en caché y usando campos de esta estructura hasta la próxima vez que anexe registros o escriba su área de reinicio. En ese momento, parte de la información se vuelve obsoleta.

Sintaxis

CLFSUSER_API BOOL GetLogFileInformation(
  [in]      HANDLE            hLog,
  [in, out] PCLFS_INFORMATION pinfoBuffer,
  [in, out] PULONG            cbBuffer
);

Parámetros

[in] hLog

Identificador de un registro abierto que se obtiene de una llamada correcta a CreateLogFile.

El identificador de registro puede hacer referencia a un registro dedicado o multiplexado.

[in, out] pinfoBuffer

Puntero a una estructura de CLFS_INFORMATION asignada por el usuario que recibe los metadatos del registro.

[in, out] cbBuffer

Puntero a una variable que en la entrada especifica el tamaño, en bytes, del búfer de metadatos al que apunta pinfoBuffer.

En la salida, especifica el número de bytes que se copian realmente en pinfoBuffer.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

En la lista siguiente se identifican los posibles códigos de error:

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado clfsw32.h
Library Clfsw32.lib
Archivo DLL Clfsw32.dll

Consulte también

CLFS_INFORMATION

Funciones comunes del sistema de archivos de registro

CreateLogFile

Obtención del siguiente LSN