アプリケーションは、メッセージ・コンシューマーを使用して、宛先に送信されたメッセージを受信します。
MessageConsumer オブジェクトの XMS 定義プロパティーのリストについては、MessageConsumer のプロパティーを参照してください。
関数 | 説明 |
---|---|
xmsMsgConsumerClose | メッセージ・コンシューマーを閉じます。 |
xmsMsgConsumerGetMessageListener | メッセージ・コンシューマーに登録されているメッセージ・リスナー関数およびコンテキスト・データへのポインターを取得します。 |
xmsMsgConsumerGetMessageSelector | メッセージ・コンシューマーのメッセージ・セレクターを取得します。 |
xmsMsgConsumerReceive | メッセージ・コンシューマーの次のメッセージを受け取ります。この呼び出しでは、無期限にメッセージを待機し続けるか、メッセージ・コンシューマーがクローズされるまで待機します。 |
xmsMsgConsumerReceiveNoWait | メッセージ・コンシューマーの次のメッセージが即時に受信可能である場合に、そのメッセージを受け取ります。 |
xmsMsgConsumerReceiveWithWait | メッセージ・コンシューマーの次のメッセージを受け取ります。この呼び出しでは、指定される期間だけメッセージを待機するか、メッセージ・コンシューマーがクローズされるまで待機します。 |
xmsMsgConsumerSetMessageListener | メッセージ・コンシューマーに、メッセージ・リスナー関数およびコンテキスト・データを登録します。 |
xmsRC xmsMsgConsumerClose(xmsHMsgConsumer *consumer, xmsHErrorBlock errorBlock);
アプリケーションが、既に閉じているメッセージ・コンシューマーを閉じようとした場合、呼び出しは無視されます。
xmsRC xmsMsgConsumerGetMessageListener(xmsHMsgConsumer consumer, fpXMS_MESSAGE_CALLBACK *lsr, xmsCONTEXT *context, xmsHErrorBlock errorBlock);
メッセージ・コンシューマーに登録されているメッセージ・リスナー関数およびコンテキスト・データへのポインターを取得します。
メッセージ・リスナー関数の使用について詳しくは、C でのメッセージ・リスナー関数の使用法を参照してください。
xmsRC xmsMsgConsumerGetMessageSelector(xmsHMsgConsumer consumer, xmsCHAR *messageSelector, xmsINT length, xmsINT *actualLength, xmsHErrorBlock errorBlock);
メッセージ・コンシューマーのメッセージ・セレクターを取得します。
この関数の使用方法について詳しくは、値によりストリングを戻す C 関数を参照してください。
xmsRC xmsMsgConsumerReceive(xmsHMsgConsumer consumer, xmsHMsg *message, xmsHErrorBlock errorBlock);
メッセージ・コンシューマーの次のメッセージを受け取ります。この呼び出しでは、無期限にメッセージを待機し続けるか、メッセージ・コンシューマーがクローズされるまで待機します。
xmsRC xmsMsgConsumerReceiveNoWait(xmsHMsgConsumer consumer, xmsHMsg *message, xmsHErrorBlock errorBlock);
メッセージ・コンシューマーの次のメッセージが即時に受信可能である場合に、そのメッセージを受け取ります。
xmsRC xmsMsgConsumerReceiveWithWait(xmsHMsgConsumer consumer, xmsLONG waitInterval, xmsHMsg *message, xmsHErrorBlock errorBlock);
メッセージ・コンシューマーの次のメッセージを受け取ります。この呼び出しでは、指定される期間だけメッセージを待機するか、メッセージ・コンシューマーがクローズされるまで待機します。
xmsRC xmsMsgConsumerSetMessageListener(xmsHMsgConsumer consumer, fpXMS_MESSAGE_CALLBACK lsr, xmsCONTEXT context, xmsHErrorBlock errorBlock);
メッセージ・コンシューマーに、メッセージ・リスナー関数およびコンテキスト・データを登録します。
メッセージ・リスナー関数の使用について詳しくは、C でのメッセージ・リスナー関数の使用法を参照してください。