Share via

Computer Property Structures

  • Article

 

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

The MQQMPROPS and MQPRIVATEPROPS structures, shown below, include a property count member to indicate the number of properties included in each structure, an array that identifies each property (aPropID), an array that specifies the value of each property (aPropVar), and an array for the returned status of each property (aStatus). Position i in each of the three arrays contains information about a single property.

The MQQMPROPS structure is defined as follows.

typedef struct tagMQQMPROPS  
{  
  DWORD          cProp;  
  QUEUEPROPID    *aPropID;  
  MQPROPVARIANT  *aPropVar;  
  HRESULT        *aStatus;  
} MQQMPROPS;

The MQQMPROPS structure is used in calls to MQGetMachineProperties.

The MQPRIVATEPROPS structure is defined as follows.

typedef struct tagMQPRIVATEPROPS  
{  
  DWORD          cProp;  
  QUEUEPROPID    *aPropID;  
  MQPROPVARIANT  *aPropVar;  
  HRESULT        *aStatus;  
} MQPRIVATEPROPS;

The MQPRIVATEPROPS structure is used in calls to MQGetPrivateComputerInformation.

aPropID, aPropVar, and aStatus

The following illustration shows how Message Queuing uses the data in these three arrays. Note that for each property the corresponding elements of the aPropID array and aPropVar array must be set to the property identifier and value, respectively.

<No Change>

When setting computer properties, if a property is set to the same value more than once, Message Queuing uses the first entry in the aPropVar array and discards all the subsequent entries. In the aStatus array, an information error value of MQ_INFORMATION_DUPLICATE_PROPERTY is returned for each discarded entry.