Función GetLogFileInformation (clfsw32.h)
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 |