ホーム › System.DistributedTransactionCoordinator › IDtcToXaMapper

IDtcToXaMapper

COM

IID64ffabe0-7ce9-11d0-8ce6-00c04fdc877e継承元IUnknown自前メソッド開始 vtbl3

メソッド 4

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

vtbl 3 HRESULT RequestNewResourceManager(LPSTR pszDSN, LPSTR pszClientDllName, DWORD* pdwRMCookie)

pszDSN	LPSTR	in	XA リソースマネージャーへ接続するためのデータソース名(DSN)を示す文字列である。
pszClientDllName	LPSTR	in	XA インターフェイスを提供するクライアント DLL の名前を示す文字列である。
pdwRMCookie	DWORD*	inout	登録されたリソースマネージャーを識別するクッキー値を受け取る DWORD へのポインタである。

vtbl 4 HRESULT TranslateTridToXid(DWORD* pdwITransaction, DWORD dwRMCookie, XID* pXid)

pdwITransaction	DWORD*	in	変換対象の DTC トランザクション識別子へのポインタである。
dwRMCookie	DWORD	in	対象リソースマネージャーを識別するクッキー値を指定する。
pXid	XID*	inout	変換結果の XA トランザクション識別子(XID)を受け取る XID へのポインタである。

vtbl 5 HRESULT EnlistResourceManager(DWORD dwRMCookie, DWORD* pdwITransaction)

dwRMCookie	DWORD	in	参加させるリソースマネージャーを識別するクッキー値を指定する。
pdwITransaction	DWORD*	in	参加対象の DTC トランザクション識別子へのポインタである。

vtbl 6 HRESULT ReleaseResourceManager(DWORD dwRMCookie)

dwRMCookie

DWORD

解放するリソースマネージャーを識別するクッキー値を指定する。

HSP用 COM定義

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

出力引数:

#define global IID_IDtcToXaMapper "{64FFABE0-7CE9-11D0-8CE6-00C04FDC877E}"
#usecom global IDtcToXaMapper IID_IDtcToXaMapper "{}"
#comfunc global IDtcToXaMapper_RequestNewResourceManager  3 str,str,var
#comfunc global IDtcToXaMapper_TranslateTridToXid         4 var,int,var
#comfunc global IDtcToXaMapper_EnlistResourceManager      5 int,var
#comfunc global IDtcToXaMapper_ReleaseResourceManager     6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IDtcToXaMapper "{64FFABE0-7CE9-11D0-8CE6-00C04FDC877E}"
#usecom global IDtcToXaMapper IID_IDtcToXaMapper "{}"
#comfunc global IDtcToXaMapper_RequestNewResourceManager  3 str,str,sptr
#comfunc global IDtcToXaMapper_TranslateTridToXid         4 sptr,int,sptr
#comfunc global IDtcToXaMapper_EnlistResourceManager      5 int,sptr
#comfunc global IDtcToXaMapper_ReleaseResourceManager     6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。