Metodo ICrmCompensator::P repareRecord (comsvcs.h)

  • Articolo

Recapita un record del log in ordine di inoltro durante la fase di preparazione. Questo metodo può essere ricevuto più volte dal CRM Compensator, una volta per ogni record di log scritto.

Sintassi

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

Parametri

[in] crmLogRec

Record di log, come struttura CrmLogRecordRead .

[out] pfForget

Indica se il record recapitato deve essere dimenticato.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

I record di log non strutturati vengono recapitati come struttura CrmLogRecordRead . Oltre ai dati utente (come singolo BLOB), questa struttura contiene un paio di campi aggiuntivi che potrebbero essere utili per il debug o la ricerca degli errori se è necessaria la compensazione umana. Il membro dwCrmFlags è un campo bit che fornisce ulteriori informazioni sul fatto che questo record sia stato dimenticato a un certo punto e quando è stato scritto. Il membro dwSequenceNumber fornisce il numero di sequenza del record di log. Nella maggior parte dei casi, i numeri di sequenza sono sequenziali, ma non sono necessariamente contigui a causa dei record di log interni che non vengono recapitati al CRM Compensator.

Se non vengono scritti record di log dal ruolo di lavoro CRM, i metodi BeginPrepare e EndPrepare vengono ricevuti, ma non sono presenti chiamate al metodo PrepareRecord . Si tratta di consentire ai compensatori CRM che scrivono record di log solo in fase di preparazione.

Crm Compensator può scegliere di dimenticare il record che viene recapitato durante questa fase impostando il flag di dimenticare sul ritorno da questo metodo.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione comsvcs.h

Vedi anche

ICrmCompensator