8.3.16 mqd_setqattr (メッセージキュー属性を設定する)

機能説明

メッセージキューの属性情報を設定します。

記述形式

---------------------------------------------------------------------------------------
      #include "mqdapi.h"
      int mqd_setqattr(MQD_MessageQueue *queue, MQD_QueueAttribute *qattr,
                       MQD_Environment *env)
---------------------------------------------------------------------------------------

パラメタ

queue

mqd_connectq関数から返されたメッセージキューへのポインタをそのまま指定します。

qattr

メッセージキュー属性情報へのポインタを指定します。事前にメッセージキュー属性情報を設定しておく必要があります。メッセージキュー属性情報(QueueAttribute構造体)の詳細については、“8.3.29 パラメタの詳細説明”を参照してください。

env

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

  MQD_ERR_SYNTAX,        MQD_ERR_NOSYSTEM,  MQD_ERR_NOCONNECT,
  MQD_ERR_NOCONNECTQUE,  MQD_ERR_IO,        MQD_ERR_NOMEMORY,
  MQD_ERR_NOQUE,         MQD_ERR_PURGEMSG,  MQD_ERR_PUTSTATUS,
  MQD_ERR_GETSTATUS

復帰値

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

正常時: 0
異常時: -1