8.3.4 mqd_createq (メッセージキューを作成する)

機能説明

メッセージキューを作成します。

記述形式

#include "mqdapi.h"
int mqd_createq(MQD_System *system, MQD_QueueAttribute *qattribute, MQD_Environment *env)

パラメタ

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

qattribute: メッセージキュー属性情報へのポインタを指定します。メッセージキュー属性情報(MQD_QueueAttribute構造体)の詳細については、“8.3.29 パラメタの詳細説明”を参照してください。

env

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

MQD_ERR_SYNTAX
MQD_ERR_NOSYSTEM
MQD_ERR_NOCONNECT
MQD_ERR_IO
MQD_ERR_NOMEMORY
MQD_ERR_NODISK
MQD_ERR_MSGFILE
MQD_ERR_QUEOVER
MQD_ERR_QUEEXIST
MQD_ERR_QNAME
MQD_ERR_GUARANTEE
MQD_ERR_QUOTA
MQD_ERR_MSGMAXLEN
MQD_ERR_PRIORITY
MQD_ERR_TIMELIMIT
MQD_ERR_PUTSTATUS
MQD_ERR_GETSTATUS

MQD_ERR_INVALIDAPI

復帰値

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

正常時:0
異常時: -1

注意事項

メッセージキューを作成するためには、MQDへ接続しておく必要があります。

当該アプリケーションがmqd_connectrdb関数を使用してMQDに接続している場合、本関数はエラー詳細コード“MQD_ERR_INVALIDAPI”で復帰します。