Función TxfLogReadRecords (txfw32.h)

  • Artículo

[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