ホーム › System.MessageQueuing › IMSMQQueue2

IMSMQQueue2

COMIDispatch (デュアル)

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDef0574e0-06d8-11d3-b100-00e02c074f6b継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 19

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Access(INT* plAccess)

plAccess

INT*

out

キューを開いた際のアクセスモードを受け取るポインタである。

vtbl 8 HRESULT get_ShareMode(INT* plShareMode)

plShareMode

INT*

out

キューを開いた際の共有モードを受け取るポインタである。

vtbl 9 HRESULT get_QueueInfo(IMSMQQueueInfo2** ppqinfo)

ppqinfo

IMSMQQueueInfo2**

out

このキューに対応するキュー情報オブジェクト(IMSMQQueueInfo2)を受け取るポインタである。

vtbl 10 HRESULT get_Handle(INT* plHandle)

plHandle

INT*

out

キューの内部ハンドルを受け取るポインタである。

vtbl 11 HRESULT get_IsOpen(SHORT* pisOpen)

pisOpen

SHORT*

out

キューが現在開かれているかどうかを受け取るポインタである。

vtbl 12 HRESULT Close()

vtbl 13 HRESULT Receive_v1(VARIANT* Transaction, VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, IMSMQMessage** ppmsg)

Transaction	VARIANT*	in	受信または送信を行うトランザクションを格納した VARIANT へのポインタである。トランザクション種別の定数を渡すことも、トランザクションオブジェクトを渡すこともできる。省略可。
WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
ppmsg	IMSMQMessage**	out	受信または参照したメッセージオブジェクト(IMSMQMessage)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 14 HRESULT Peek_v1(VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, IMSMQMessage** ppmsg)

WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
ppmsg	IMSMQMessage**	out	受信または参照したメッセージオブジェクト(IMSMQMessage)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 15 HRESULT EnableNotification(IMSMQEvent2* Event, VARIANT* Cursor, VARIANT* ReceiveTimeout)

Event	IMSMQEvent2*	inoptional	メッセージ到着を非同期に通知する MSMQ イベントオブジェクトへのポインタである。
Cursor	VARIANT*	in	走査位置を制御するカーソル種別を格納した VARIANT へのポインタである。省略可。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。

vtbl 16 HRESULT Reset()

vtbl 17 HRESULT ReceiveCurrent_v1(VARIANT* Transaction, VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, IMSMQMessage** ppmsg)

Transaction	VARIANT*	in	受信または送信を行うトランザクションを格納した VARIANT へのポインタである。トランザクション種別の定数を渡すことも、トランザクションオブジェクトを渡すこともできる。省略可。
WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
ppmsg	IMSMQMessage**	out	受信または参照したメッセージオブジェクト(IMSMQMessage)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 18 HRESULT PeekNext_v1(VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, IMSMQMessage** ppmsg)

WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
ppmsg	IMSMQMessage**	out	受信または参照したメッセージオブジェクト(IMSMQMessage)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 19 HRESULT PeekCurrent_v1(VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, IMSMQMessage** ppmsg)

WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
ppmsg	IMSMQMessage**	out	受信または参照したメッセージオブジェクト(IMSMQMessage)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 20 HRESULT Receive(VARIANT* Transaction, VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, VARIANT* WantConnectorType, IMSMQMessage2** ppmsg)

Transaction	VARIANT*	in	受信または送信を行うトランザクションを格納した VARIANT へのポインタである。トランザクション種別の定数を渡すことも、トランザクションオブジェクトを渡すこともできる。省略可。
WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
WantConnectorType	VARIANT*	in	コネクタ種別の情報を取得するかどうかを格納した VARIANT へのポインタである。省略可。
ppmsg	IMSMQMessage2**	out	受信または参照したメッセージオブジェクト(IMSMQMessage2)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 21 HRESULT Peek(VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, VARIANT* WantConnectorType, IMSMQMessage2** ppmsg)

WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
WantConnectorType	VARIANT*	in	コネクタ種別の情報を取得するかどうかを格納した VARIANT へのポインタである。省略可。
ppmsg	IMSMQMessage2**	out	受信または参照したメッセージオブジェクト(IMSMQMessage2)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 22 HRESULT ReceiveCurrent(VARIANT* Transaction, VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, VARIANT* WantConnectorType, IMSMQMessage2** ppmsg)

Transaction	VARIANT*	in	受信または送信を行うトランザクションを格納した VARIANT へのポインタである。トランザクション種別の定数を渡すことも、トランザクションオブジェクトを渡すこともできる。省略可。
WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
WantConnectorType	VARIANT*	in	コネクタ種別の情報を取得するかどうかを格納した VARIANT へのポインタである。省略可。
ppmsg	IMSMQMessage2**	out	受信または参照したメッセージオブジェクト(IMSMQMessage2)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 23 HRESULT PeekNext(VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, VARIANT* WantConnectorType, IMSMQMessage2** ppmsg)

WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
WantConnectorType	VARIANT*	in	コネクタ種別の情報を取得するかどうかを格納した VARIANT へのポインタである。省略可。
ppmsg	IMSMQMessage2**	out	受信または参照したメッセージオブジェクト(IMSMQMessage2)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 24 HRESULT PeekCurrent(VARIANT* WantDestinationQueue, VARIANT* WantBody, VARIANT* ReceiveTimeout, VARIANT* WantConnectorType, IMSMQMessage2** ppmsg)

WantDestinationQueue	VARIANT*	in	受信するメッセージの宛先キュー情報を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得しない。
WantBody	VARIANT*	in	受信するメッセージの本文を取得するかどうかを格納した VARIANT へのポインタである。省略時は取得する。
ReceiveTimeout	VARIANT*	in	メッセージが到着するまで待機する最大時間(ミリ秒)を格納した VARIANT へのポインタである。省略時は無限に待機する。
WantConnectorType	VARIANT*	in	コネクタ種別の情報を取得するかどうかを格納した VARIANT へのポインタである。省略可。
ppmsg	IMSMQMessage2**	out	受信または参照したメッセージオブジェクト(IMSMQMessage2)を受け取るポインタである。要求に該当するメッセージが無い場合は NULL が返る。

vtbl 25 HRESULT get_Properties(IDispatch** ppcolProperties)

ppcolProperties

IDispatch**

out

オブジェクトのプロパティコレクション(IDispatch)を受け取るポインタである。将来の拡張用に予約されている。

HSP用 COM定義

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

出力引数:

#define global IID_IMSMQQueue2 "{EF0574E0-06D8-11D3-B100-00E02C074F6B}"
#usecom global IMSMQQueue2 IID_IMSMQQueue2 "{D7D6E079-DCCD-11D0-AA4B-0060970DEBAE}"
#comfunc global IMSMQQueue2_get_Access          7 var
#comfunc global IMSMQQueue2_get_ShareMode       8 var
#comfunc global IMSMQQueue2_get_QueueInfo       9 sptr
#comfunc global IMSMQQueue2_get_Handle          10 var
#comfunc global IMSMQQueue2_get_IsOpen          11 var
#comfunc global IMSMQQueue2_Close               12
#comfunc global IMSMQQueue2_Receive_v1          13 var,var,var,var,sptr
#comfunc global IMSMQQueue2_Peek_v1             14 var,var,var,sptr
#comfunc global IMSMQQueue2_EnableNotification  15 sptr,var,var
#comfunc global IMSMQQueue2_Reset               16
#comfunc global IMSMQQueue2_ReceiveCurrent_v1   17 var,var,var,var,sptr
#comfunc global IMSMQQueue2_PeekNext_v1         18 var,var,var,sptr
#comfunc global IMSMQQueue2_PeekCurrent_v1      19 var,var,var,sptr
#comfunc global IMSMQQueue2_Receive             20 var,var,var,var,var,sptr
#comfunc global IMSMQQueue2_Peek                21 var,var,var,var,sptr
#comfunc global IMSMQQueue2_ReceiveCurrent      22 var,var,var,var,var,sptr
#comfunc global IMSMQQueue2_PeekNext            23 var,var,var,var,sptr
#comfunc global IMSMQQueue2_PeekCurrent         24 var,var,var,var,sptr
#comfunc global IMSMQQueue2_get_Properties      25 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IMSMQQueue2 "{EF0574E0-06D8-11D3-B100-00E02C074F6B}"
#usecom global IMSMQQueue2 IID_IMSMQQueue2 "{D7D6E079-DCCD-11D0-AA4B-0060970DEBAE}"
#comfunc global IMSMQQueue2_get_Access          7 sptr
#comfunc global IMSMQQueue2_get_ShareMode       8 sptr
#comfunc global IMSMQQueue2_get_QueueInfo       9 sptr
#comfunc global IMSMQQueue2_get_Handle          10 sptr
#comfunc global IMSMQQueue2_get_IsOpen          11 sptr
#comfunc global IMSMQQueue2_Close               12
#comfunc global IMSMQQueue2_Receive_v1          13 sptr,sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_Peek_v1             14 sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_EnableNotification  15 sptr,sptr,sptr
#comfunc global IMSMQQueue2_Reset               16
#comfunc global IMSMQQueue2_ReceiveCurrent_v1   17 sptr,sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_PeekNext_v1         18 sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_PeekCurrent_v1      19 sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_Receive             20 sptr,sptr,sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_Peek                21 sptr,sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_ReceiveCurrent      22 sptr,sptr,sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_PeekNext            23 sptr,sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_PeekCurrent         24 sptr,sptr,sptr,sptr,sptr
#comfunc global IMSMQQueue2_get_Properties      25 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。