Méthode ILog::ReadRecordPrefix (txlogpub.h)

Article
08/26/2023

Lit une partie initiale d’un enregistrement à partir du journal.

Syntaxe

HRESULT ReadRecordPrefix(
  [in]      LSN   lsnToRead,
  [in, out] LSN   *plsnPrev,
  [in, out] LSN   *plsnNext,
  [out]     BYTE  *pbData,
  [in, out] ULONG *pcbData,
  [out]     ULONG *pcbRecord
);

Paramètres

[in] lsnToRead

LSN de l’enregistrement à lire.

[in, out] plsnPrev

Pointeur vers le LSN de l’enregistrement précédent (l’enregistrement précédant immédiatement l’enregistrement à lire). Vous pouvez passer la valeur NULL si le LSN de l’enregistrement précédent n’est pas nécessaire. Ce paramètre est égal à 0 s’il n’existe aucun enregistrement précédent dans le journal ou si une erreur se produit.

[in, out] plsnNext

Pointeur vers le LSN de l’enregistrement suivant (l’enregistrement qui suit immédiatement l’enregistrement à lire). Vous pouvez passer la valeur NULL si le LSN de l’enregistrement suivant n’est pas nécessaire. Ce paramètre est MAXLSN (0x7FFFFFFFFFFFFFFF) s’il n’existe aucun enregistrement suivant dans le journal. Ce paramètre est 0 si une erreur se produit.

[out] pbData

Pointeur vers une mémoire tampon dans laquelle les données d’enregistrement doivent être lues.

[in, out] pcbData

Pointeur vers une variable qui contient la taille en octets de la mémoire tampon lors de l’entrée et qui contiendra la taille en octets des données d’enregistrement lues au retour.

[out] pcbRecord

Pointeur vers une variable qui contiendra la taille en octets de l’enregistrement entier au retour. Vous pouvez passer la valeur NULL si la taille de l’enregistrement entier n’est pas nécessaire.

Valeur retournée

Cette méthode peut retourner les valeurs suivantes, ainsi que d’autres valeurs HRESULT .

Code de retour	Description
S_OK	L’enregistrement a été lu avec succès à partir du journal.
XACT_E_INVALIDLSN	lsnToRead est en dehors des limites actuelles du journal. Consultez ILog::GetLogLimits.
E_INVALIDARG	lsnToRead se trouve dans les limites actuelles du journal, mais il ne s’agit pas du nom de domaine d’un enregistrement dans le journal.

Remarques

Bien que les enregistrements ajoutés au journal à l’aide d’ILog::AppendRecord puissent être concaténés à partir de plusieurs objets BLOB, ReadRecordPrefix retourne l’enregistrement sous la forme d’un objet blob opaque unique de données. ILog ne fournit aucune méthode pour extraire des objets BLOB individuels de l’enregistrement. Il incombe à l’appelant d’analyser les données dans les enregistrements retournés par ReadRecordPrefix.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	txlogpub.h

Voir aussi

Ilog

Partager via