Fonction TxfLogReadRecords (txfw32.h)

Article
08/26/2023

[Microsoft recommande vivement aux développeurs d’utiliser d’autres moyens pour répondre aux besoins de votre application. De nombreux scénarios utilisant TxF peuvent être réalisés à l’aide de techniques plus simples et plus facilement disponibles. En outre, TxF peut ne pas être disponible dans les versions à venir de Microsoft Windows. Pour plus d’informations et les alternatives à TxF, consultez Alternatives à l’utilisation de Transactionnel NTFS.]

Lit les enregistrements de restauration par progression dans le journal.

Syntaxe

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

Paramètres

[in] TxfLogContext

Pointeur vers le contexte.

[in] BufferLength

Taille de la mémoire tampon de sortie en octets.

[out] Buffer

Pointeur vers la mémoire tampon qui reçoit les enregistrements. Pour plus d’informations, consultez TXF_LOG_RECORD_BASE.

[out] BytesUsed

Nombre d’octets écrits dans la mémoire tampon de sortie.

[out] RecordCount

Nombre d’enregistrements écrits dans la mémoire tampon de sortie.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Les codes d’erreur possibles sont les suivants.

Code de retour	Description
ERROR_INVALID_HANDLE	Le contexte de réplication n’est pas valide.
ERROR_MORE_DATA	Certains des enregistrements disponibles ont été copiés dans la mémoire tampon. Appelez à nouveau cette fonction pour récupérer le reste des enregistrements.
ERROR_INSUFFICIENT_BUFFER	La mémoire tampon n’est pas assez grande pour contenir ne fût-ce qu’un seul enregistrement. Si BytesUsed est différent de zéro, il y avait suffisamment d’espace pour copier la structure TXF_LOG_RECORD_BASE , ce qui indique la taille de mémoire tampon requise pour lire l’enregistrement complet suivant.
ERROR_FILE_CORRUPT	Le format du fichier journal en cours de traitement n’est pas reconnu.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	txfw32.h
Bibliothèque	TxfW32.lib
DLL	TxfW32.dll

Voir aussi

TXF_LOG_RECORD_BASE