Función TxfLogReadRecords (txfw32.h)

Artículo
03/03/2024

[Microsoft recomienda encarecidamente que los desarrolladores usen medios alternativos para lograr las necesidades de la aplicación. Muchos escenarios para los que se desarrolló TxF se pueden lograr mediante técnicas más sencillas y disponibles. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional].

Lee los registros de puesta al día del registro.

Sintaxis

BOOL TxfLogReadRecords(
  [in]  PVOID  TxfLogContext,
  [in]  ULONG  BufferLength,
  [out] PVOID  Buffer,
  [out] PULONG BytesUsed,
  [out] PULONG RecordCount
);

Parámetros

[in] TxfLogContext

Puntero al contexto.

[in] BufferLength

Tamaño del búfer de salida, en bytes.

[out] Buffer

Puntero al búfer que recibe los registros. Para obtener más información, consulte TXF_LOG_RECORD_BASE.

[out] BytesUsed

Número de bytes escritos en el búfer de salida.

[out] RecordCount

Número de registros escritos en el búfer de salida.

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. Entre los posibles códigos de error se incluyen los siguientes.

Código devuelto	Descripción
ERROR_INVALID_HANDLE	El contexto de replicación no es válido.
ERROR_MORE_DATA	Algunos de los registros disponibles se copiaron en el búfer. Vuelva a llamar a esta función para recuperar el resto de los registros.
ERROR_INSUFFICIENT_BUFFER	El búfer no es lo suficientemente grande como para contener incluso un registro. Si BytesUsed es distinto de cero, había suficiente espacio para copiar la estructura de TXF_LOG_RECORD_BASE , lo que indica el tamaño de búfer necesario para leer el siguiente registro completo.
ERROR_FILE_CORRUPT	No se reconoce el formato del archivo de registro que se está procesando.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	txfw32.h
Library	TxfW32.lib
Archivo DLL	TxfW32.dll

Consulte también

TXF_LOG_RECORD_BASE