ホーム › System.ComponentServices › IComCRMEvents
IComCRMEvents
COM公式ドキュメント
コンポーネントサービスの Compensating Resource Manager (CRM) 機能のアクティビティをサブスクライバーに通知します。
メソッド 15
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT OnCRMRecoveryStart(COMSVCSEVENTINFO* pInfo, GUID guidApp)
CRM の回復が開始されたときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidApp | GUID | in | アプリケーションのグローバル一意識別子 (GUID)。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 4 HRESULT OnCRMRecoveryDone(COMSVCSEVENTINFO* pInfo, GUID guidApp)
CRM の回復が完了したときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidApp | GUID | in | アプリケーションのグローバル一意識別子 (GUID)。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 5 HRESULT OnCRMCheckpoint(COMSVCSEVENTINFO* pInfo, GUID guidApp)
CRM のチェックポイントが発生したときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidApp | GUID | in | アプリケーションのグローバル一意識別子 (GUID)。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 6 HRESULT OnCRMBegin(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID, GUID guidActivity, GUID guidTx, LPWSTR szProgIdCompensator, LPWSTR szDescription)
クライアントによるコンペンセーターの登録により、または回復中に、CRM クラークが起動するときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
| guidActivity | GUID | in | アクティビティ識別子 (回復の場合は NULL)。 |
| guidTx | GUID | in | トランザクション作業単位 (UOW) の識別子。 |
| szProgIdCompensator | LPWSTR | in | CRM コンペンセーターの ProgID。 |
| szDescription | LPWSTR | in | 説明 (回復の場合は空白)。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 7 HRESULT OnCRMPrepare(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID)
CRM クラークが、CRM コンペンセーターへ引き渡すための prepare (準備) 通知を受け取ったときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 8 HRESULT OnCRMCommit(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID)
CRM クラークが、CRM コンペンセーターへ引き渡すための commit (コミット) 通知を受け取ったときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 9 HRESULT OnCRMAbort(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID)
CRM クラークが、CRM コンペンセーターへ引き渡すための abort (中止) 通知を受け取ったときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 10 HRESULT OnCRMIndoubt(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID)
CRM クラークが、CRM コンペンセーターへ引き渡すための in-doubt (未確定) 通知を受け取ったときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 11 HRESULT OnCRMDone(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID)
CRM クラークがトランザクションの結果通知の処理を完了したときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 12 HRESULT OnCRMRelease(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID)
CRM クラークが完了し、リソースロックを解放したときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 13 HRESULT OnCRMAnalyze(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID, DWORD dwCrmRecordType, DWORD dwRecordSize)
回復の分析フェーズ中に CRM クラークがレコードを受け取ったときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
| dwCrmRecordType | DWORD | in | CRM ログレコードの種類 (内部用)。 |
| dwRecordSize | DWORD | in | ログレコードのサイズ (概算)。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 14 HRESULT OnCRMWrite(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID, BOOL fVariants, DWORD dwRecordSize)
CRM ワーカーまたは CRM コンペンセーターから、ログレコードを書き込む要求を CRM クラークが受け取ったときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
| fVariants | BOOL | in | ログレコードが Variant 配列として書き込まれるかどうかを示します。 |
| dwRecordSize | DWORD | in | ログレコードのサイズ (概算)。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 15 HRESULT OnCRMForget(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID)
CRM ワーカーまたは CRM コンペンセーターから、ログレコードを破棄 (forget) する要求を CRM クラークが受け取ったときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 16 HRESULT OnCRMForce(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID)
CRM ワーカーまたは CRM コンペンセーターから、ログレコードをディスクへ強制書き込み (force) する要求を CRM クラークが受け取ったときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
vtbl 17 HRESULT OnCRMDeliver(COMSVCSEVENTINFO* pInfo, GUID guidClerkCLSID, BOOL fVariants, DWORD dwRecordSize)
CRM クラークが CRM コンペンセーターにレコードを配信するときに生成されます。
| pInfo | COMSVCSEVENTINFO* | in | COMSVCSEVENTINFO 構造体へのポインター。 |
| guidClerkCLSID | GUID | in | CRM クラークの識別子。 |
| fVariants | BOOL | in | ログレコードが Variant 配列として書き込まれるかどうかを示します。 |
| dwRecordSize | DWORD | in | ログレコードのサイズ (概算)。 |
戻り値
このメソッドの戻り値はユーザーが検証します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IComCRMEvents "{683130B5-2E50-11D2-98A5-00C04F8EE1C4}" #usecom global IComCRMEvents IID_IComCRMEvents "{}" #comfunc global IComCRMEvents_OnCRMRecoveryStart 3 var,int #comfunc global IComCRMEvents_OnCRMRecoveryDone 4 var,int #comfunc global IComCRMEvents_OnCRMCheckpoint 5 var,int #comfunc global IComCRMEvents_OnCRMBegin 6 var,int,int,int,wstr,wstr #comfunc global IComCRMEvents_OnCRMPrepare 7 var,int #comfunc global IComCRMEvents_OnCRMCommit 8 var,int #comfunc global IComCRMEvents_OnCRMAbort 9 var,int #comfunc global IComCRMEvents_OnCRMIndoubt 10 var,int #comfunc global IComCRMEvents_OnCRMDone 11 var,int #comfunc global IComCRMEvents_OnCRMRelease 12 var,int #comfunc global IComCRMEvents_OnCRMAnalyze 13 var,int,int,int #comfunc global IComCRMEvents_OnCRMWrite 14 var,int,int,int #comfunc global IComCRMEvents_OnCRMForget 15 var,int #comfunc global IComCRMEvents_OnCRMForce 16 var,int #comfunc global IComCRMEvents_OnCRMDeliver 17 var,int,int,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IComCRMEvents "{683130B5-2E50-11D2-98A5-00C04F8EE1C4}" #usecom global IComCRMEvents IID_IComCRMEvents "{}" #comfunc global IComCRMEvents_OnCRMRecoveryStart 3 sptr,int #comfunc global IComCRMEvents_OnCRMRecoveryDone 4 sptr,int #comfunc global IComCRMEvents_OnCRMCheckpoint 5 sptr,int #comfunc global IComCRMEvents_OnCRMBegin 6 sptr,int,int,int,wstr,wstr #comfunc global IComCRMEvents_OnCRMPrepare 7 sptr,int #comfunc global IComCRMEvents_OnCRMCommit 8 sptr,int #comfunc global IComCRMEvents_OnCRMAbort 9 sptr,int #comfunc global IComCRMEvents_OnCRMIndoubt 10 sptr,int #comfunc global IComCRMEvents_OnCRMDone 11 sptr,int #comfunc global IComCRMEvents_OnCRMRelease 12 sptr,int #comfunc global IComCRMEvents_OnCRMAnalyze 13 sptr,int,int,int #comfunc global IComCRMEvents_OnCRMWrite 14 sptr,int,int,int #comfunc global IComCRMEvents_OnCRMForget 15 sptr,int #comfunc global IComCRMEvents_OnCRMForce 16 sptr,int #comfunc global IComCRMEvents_OnCRMDeliver 17 sptr,int,int,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。