Partager via

Méthode ICrmCompensator ::P repareRecord (comsvcs.h)

  • Article

Remet un enregistrement du journal dans l'ordre de transmission pendant la phase de préparation. Cette méthode peut être reçue par l’compensateur CRM plusieurs fois, une fois pour chaque enregistrement de journal écrit.

Syntaxe

HRESULT PrepareRecord(
  [in]  CrmLogRecordRead crmLogRec,
  [out] BOOL             *pfForget
);

Paramètres

[in] crmLogRec

Enregistrement de journal, en tant que structure CrmLogRecordRead .

[out] pfForget

Indique si l’enregistrement remis doit être oublié.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les enregistrements de journal non structurés sont fournis sous la forme d’une structure CrmLogRecordRead . En plus des données utilisateur (en tant qu’objet BLOB unique), cette structure contient quelques champs supplémentaires qui peuvent être utiles pour le débogage ou la recherche d’erreurs si une compensation humaine est nécessaire. Le membre dwCrmFlags est un champ de bits qui fournit des informations supplémentaires sur la question de savoir si cet enregistrement a été oublié à un moment donné et quand il a été écrit. Le membre dwSequenceNumber fournit le numéro de séquence de l’enregistrement de journal. Dans la plupart des cas, les numéros de séquence sont séquentiels, mais ne sont pas nécessairement contigus en raison des enregistrements de journal internes qui ne sont pas remis à l’compensateur CRM.

Si aucun enregistrement de journal n’est écrit par le worker CRM, les méthodes BeginPrepare et EndPrepare sont reçues, mais il n’y a pas d’appels de méthode PrepareRecord . Cela permet aux compensateurs CRM d’écrire des enregistrements de journal au moment de la préparation uniquement.

L’compensateur CRM peut choisir d’oublier l’enregistrement qui lui est remis au cours de cette phase en définissant l’indicateur d’oubli au retour de cette méthode.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête comsvcs.h

Voir aussi

ICrmCompensator