8.3.15 mqd_getqattr (メッセージキュー属性を通知する)

機能説明

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

記述形式

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

パラメタ

queue

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

qattr

メッセージキュー属性情報を通知する領域へのポインタを指定します。この領域は発行元が用意します。メッセージキュー属性情報(MQD_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

復帰値

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

正常時: 0
異常時: -1