mqAddInteger

mqAddInteger的语法

mqAddInteger (Bag, Selector, ItemValue, CompCode, Reason)

mqAddInteger的参数

包 (MQHBAG)-输入

要修改的包的手柄。

这必须是用户创建的包的句柄，而不是系统包的句柄。 MQRC_SYSTEM_BAG_NOT_ALTERABLE 结果 (如果您指定的值标识系统包)。

选择器 (MQLONG)

用于标识要添加到包中的项的选择器。

如果选择器小于零 (即，系统选择器) ，那么将生成 MQRC_SELECTOR_OUT_OF_RANGE 结果。

如果选择器为零或大于零 (即，用户选择器) ，并且包是使用 MQCBO_CHECK_SELECTORS 选项或作为管理包 (MQCBO_ADMIN_BAG) 创建的，那么选择器必须在 MQIA_FIRST 到MQIA_LAST的范围内; 否则，又是 MQRC_SELECTOR_OUT_OF_RANGE 结果。

如果未指定 MQCBO_CHECK_SELECTORS ，那么选择器可以是任何值 0 或更大的值。

如果调用正在创建已在包中的选择器的第二次或以后出现，那么此出现的数据类型必须与第一次出现的数据类型相同; 如果没有，那么会生成 MQRC_INCONSISTENT_ITEM_TYPE 结果。

ItemValue (MQLONG)-输入

要放在包中的整数值。

CompCode (MQLONG)-输出

完成代码。

原因 (MQLONG)-输出

原因码限定 CompCode。

以下原因代码表示mqAddInteger调用可能返回的错误条件：

mqrc_hbag_error

包句柄无效。

mqrc_inconsistent_item_type

此选择器出现的数据类型与首次出现的数据类型不同。

mqrc_selector_out_of_range

选择器不在调用的有效范围内。

MQRC_STORAGE_NOT_AVAILABLE

可用存储器不足。

mqrc_system_bag_not_alterable

不能更改或删除系统包。

mqAddInteger的使用说明

1. 如果包中已存在具有指定选择器的数据项，那么会将该选择器的其他实例添加到包的末尾。 新实例不一定与现有实例相邻。
2. 此调用不能用于将系统选择器添加到包中。

mqAddInteger的 C 语言调用

mqAddInteger (Bag, Selector, ItemValue, &CompCode, &Reason)

MQHBAG   Bag;       /* Bag handle */
MQLONG   Selector;  /* Selector */
MQLONG   ItemValue; /* Integer value */
MQLONG   CompCode;  /* Completion code */
MQLONG   Reason;    /* Reason code qualifying CompCode */

mqAddInteger的 Visual Basic 调用

(仅在 Windows 上受支持。)

mqAddInteger Bag, Selector, ItemValue, CompCode, Reason

Dim Bag       As Long 'Bag handle'
Dim Selector  As Long 'Selector'
Dim ItemValue As Long 'Integer value'
Dim CompCode  As Long 'Completion code'
Dim Reason    As Long 'Reason code qualifying CompCode'