Win32 API 日本語リファレンス
ホームSystem.DistributedTransactionCoordinator › IResourceManager

IResourceManager

COM
IID13741d21-87eb-11ce-8081-0080c758527e継承元IUnknown自前メソッド開始 vtbl3

メソッド 4

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT Enlist(ITransaction* pTransaction, ITransactionResourceAsync* pRes, BOID* pUOW, INT* pisoLevel, ITransactionEnlistmentAsync** ppEnlist)
pTransactionITransaction*inoptional参加対象のトランザクションを表す ITransaction ポインタである。
pResITransactionResourceAsync*inoptionalリソースマネージャー側の非同期通知を受け取る ITransactionResourceAsync ポインタである。
pUOWBOID*outトランザクションの作業単位(Unit Of Work)を識別する BOID を受け取るポインタである。
pisoLevelINT*outトランザクションの分離レベル(Isolation Level)を受け取る INT へのポインタである。
ppEnlistITransactionEnlistmentAsync**out生成された参加(エンリストメント)を表す ITransactionEnlistmentAsync インターフェイスへのポインタを受け取る。
vtbl 4 HRESULT Reenlist(BYTE* pPrepInfo, DWORD cbPrepInfo, DWORD lTimeout, XACTSTAT* pXactStat)
pPrepInfoBYTE*in準備フェーズで取得したリカバリ情報(Prepare Info)を格納したバッファへのポインタである。
cbPrepInfoDWORDinpPrepInfo が指すバッファのバイト数を指定する。
lTimeoutDWORDinトランザクション結果が判明するまで待機する最大時間をミリ秒単位で指定する。
pXactStatXACTSTAT*out再参加したトランザクションの結果(コミット済み・中止済み等)を受け取る XACTSTAT へのポインタである。
vtbl 5 HRESULT ReenlistmentComplete()
vtbl 6 HRESULT GetDistributedTransactionManager(GUID* iid, void** ppvObject)
iidGUID*in要求するインターフェイスの識別子(IID)を示す GUID へのポインタである。
ppvObjectvoid**out取得した分散トランザクションマネージャーのインターフェイスポインタを受け取る。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_IResourceManager "{13741D21-87EB-11CE-8081-0080C758527E}"
#usecom global IResourceManager IID_IResourceManager "{}"
#comfunc global IResourceManager_Enlist                            3 sptr,sptr,var,var,sptr
#comfunc global IResourceManager_Reenlist                          4 var,int,int,var
#comfunc global IResourceManager_ReenlistmentComplete              5
#comfunc global IResourceManager_GetDistributedTransactionManager  6 var,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。