8.3.20 mqd_connectqex (複数のメッセージキューに接続する)

機能説明

当該アプリケーションを複数のメッセージキューに接続します。

記述形式

#include "mqdapi.h"
int mqd_connectqex(MQD_System *system, MQD_QueueName *qnamearray, int qnum, int *errqueindex, MQD_Environment *env, MQD_MessageQueueex **queuegroup)

パラメタ

system: mqd_connect関数から返されたMQDシステム情報へのポインタをそのまま指定します。

qnamearray: 接続するメッセージキュー名の配列の先頭を指すポインタを指定します。メッセージキュー名は、メッセージキューを作成したときに指定したメッセージキューの名前です。qnumで指定した分の領域を用意する必要があります。メッセージキュー名の一覧(MQD_QueueName構造体)の詳細については、“8.3.29 パラメタの詳細説明”を参照してください。

qnum: 接続するメッセージキューの個数を指定します。

errqueindex

異常が発生したメッセージキューのインデックスが通知されます。インデックスは、メッセージキュー名の配列のインデックスで、以下のように通知されます。

0,1,2,…,n：異常が発生したメッセージキューのインデックス
-1：メッセージキューに関係なく異常復帰した場合

env

例外処理のための復帰情報へのポインタを指定します。エラー詳細コードに以下の値が返されます。復帰情報(MQD_Environment構造体)の詳細については、“8.4 復帰情報の説明”を参照してください。

errqueindexに“-1”を通知するエラー詳細コード: MQD_ERR_SYNTAX
MQD_ERR_NOSYSTEM
MQD_ERR_INVALIDAPI

errqueindexにメッセージキューのインデックスを通知するエラー詳細コード: MQD_ERR_OPENQUEOVER
MQD_ERR_NOQUE
MQD_ERR_QUEUSE,
MQD_ERR_QNAME

errqueindexにメッセージキューのインデックス、または、“-1”を通知するエラー詳細コード: MQD_ERR_NOCONNECT
MQD_ERR_NOMEMORY
MQD_ERR_PROCESSOVER

queuegroup: メッセージキューに接続できた場合にはメッセージキューグループ(MQD_MessageQueueex構造体)へのポインタを返します。メッセージキューグループは、メッセージキュー名の一覧で指定した複数のメッセージキューを管理するものです。メッセージキューグループへのポインタは、後述のmqd_disconnectqex、mqd_getmsgex、mqd_peekmsgex、mqd_seekmsgexの各関数の入力パラメタとして使用します。

復帰値

本関数の処理結果が以下の復帰値で通知されます。

正常時:0
異常時: -1

注意事項

メッセージキューに接続するためには、MQDを起動し、メッセージキューを作成しておく必要があります。
本関数が異常復帰した場合は、qnamearrayで指定したすべてのメッセージキューから切断します。
本関数を、1つのスレッドで複数呼び出すことはできません。