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

IComQCEvents

COM
📘 Microsoft Learn (日本語) · English
IID683130b2-2e50-11d2-98a5-00c04f8ee1c4継承元IUnknown自前メソッド開始 vtbl3

メソッド 7

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

vtbl 3 HRESULT OnQCRecord(COMSVCSEVENTINFO* pInfo, ULONGLONG objid, LPWSTR szQueue, GUID* guidMsgId, GUID* guidWorkFlowId, HRESULT msmqhr)
pInfoCOMSVCSEVENTINFO*inイベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。
objidULONGLONGin対象オブジェクトの識別子を渡す。
szQueueLPWSTRin対象キューの名前を指定する。
guidMsgIdGUID*in対象メッセージを識別する GUID へのポインタである。
guidWorkFlowIdGUID*in対象ワークフローを識別する GUID へのポインタである。
msmqhrHRESULTinMSMQ 処理の結果を示す HRESULT を渡す。
vtbl 4 HRESULT OnQCQueueOpen(COMSVCSEVENTINFO* pInfo, LPWSTR szQueue, ULONGLONG QueueID, HRESULT hr)
pInfoCOMSVCSEVENTINFO*inイベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。
szQueueLPWSTRin開かれたキューの名前を指定する。
QueueIDULONGLONGin開かれたキューの識別子を渡す。
hrHRESULTinキューを開いた結果を示す HRESULT を渡す。
vtbl 5 HRESULT OnQCReceive(COMSVCSEVENTINFO* pInfo, ULONGLONG QueueID, GUID* guidMsgId, GUID* guidWorkFlowId, HRESULT hr)
pInfoCOMSVCSEVENTINFO*inイベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。
QueueIDULONGLONGin受信元キューの識別子を渡す。
guidMsgIdGUID*in受信したメッセージを識別する GUID へのポインタである。
guidWorkFlowIdGUID*in対象ワークフローを識別する GUID へのポインタである。
hrHRESULTin受信処理の結果を示す HRESULT を渡す。
vtbl 6 HRESULT OnQCReceiveFail(COMSVCSEVENTINFO* pInfo, ULONGLONG QueueID, HRESULT msmqhr)
pInfoCOMSVCSEVENTINFO*inイベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。
QueueIDULONGLONGin受信に失敗したキューの識別子を渡す。
msmqhrHRESULTinMSMQ 受信失敗の理由を示す HRESULT を渡す。
vtbl 7 HRESULT OnQCMoveToReTryQueue(COMSVCSEVENTINFO* pInfo, GUID* guidMsgId, GUID* guidWorkFlowId, DWORD RetryIndex)
pInfoCOMSVCSEVENTINFO*inイベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。
guidMsgIdGUID*in再試行キューへ移動したメッセージを識別する GUID へのポインタである。
guidWorkFlowIdGUID*in対象ワークフローを識別する GUID へのポインタである。
RetryIndexDWORDin再試行の回数を示すインデックスを渡す。
vtbl 8 HRESULT OnQCMoveToDeadQueue(COMSVCSEVENTINFO* pInfo, GUID* guidMsgId, GUID* guidWorkFlowId)
pInfoCOMSVCSEVENTINFO*inイベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。
guidMsgIdGUID*in配信不能キューへ移動したメッセージを識別する GUID へのポインタである。
guidWorkFlowIdGUID*in対象ワークフローを識別する GUID へのポインタである。
vtbl 9 HRESULT OnQCPlayback(COMSVCSEVENTINFO* pInfo, ULONGLONG objid, GUID* guidMsgId, GUID* guidWorkFlowId, HRESULT hr)
pInfoCOMSVCSEVENTINFO*inイベント発生時の状況を示す COMSVCSEVENTINFO 構造体へのポインタである。
objidULONGLONGin再生対象オブジェクトの識別子を渡す。
guidMsgIdGUID*in再生されたメッセージを識別する GUID へのポインタである。
guidWorkFlowIdGUID*in対象ワークフローを識別する GUID へのポインタである。
hrHRESULTin再生処理の結果を示す HRESULT を渡す。

HSP用 COM定義

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

出力引数: 
#define global IID_IComQCEvents "{683130B2-2E50-11D2-98A5-00C04F8EE1C4}"
#usecom global IComQCEvents IID_IComQCEvents "{}"
#comfunc global IComQCEvents_OnQCRecord            3 var,int64,wstr,var,var,int
#comfunc global IComQCEvents_OnQCQueueOpen         4 var,wstr,int64,int
#comfunc global IComQCEvents_OnQCReceive           5 var,int64,var,var,int
#comfunc global IComQCEvents_OnQCReceiveFail       6 var,int64,int
#comfunc global IComQCEvents_OnQCMoveToReTryQueue  7 var,var,var,int
#comfunc global IComQCEvents_OnQCMoveToDeadQueue   8 var,var,var
#comfunc global IComQCEvents_OnQCPlayback          9 var,int64,var,var,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。