Message Queuing(MSMQ)学习之旅（二）——创建Queue

1.前言

应用程序创建的Queue根据你是否希望被其他程序找到可分为Public Queue和Private Queue,Public Queue会在directory service中注册，有利于长时间的使用。Private Queue在本机注册，而不在directory service中注册，它一般通过在%windir%\System32\MSMQ\Storage\Lqs下存储相应的描叙文件来注册。注册在本机中的Public Queue也会在Lqs目录下存储相应的描述文件。建立Private Queue更快，能在directory service不工作的时候正常工作。
另外按照可以接收的Message类型可分为Transactional Queue和Nontransactional Queue。

2.创建Public Nontransactional Queue

HRESULT CreatePublicNontranMSMQQueue(
                        LPWSTR wszPathName, 
                        LPWSTR wszOutFormatName,
                        DWORD *pdwOutFormatNameLength
                        )
{
  // Validate the input parameters.
  if (wszPathName == NULL || wszOutFormatName == NULL || pdwOutFormatNameLength == NULL)
  {
    return MQ_ERROR_INVALID_PARAMETER;
  }

  // Define the maximum number of queue properties.
  const int NUMBEROFPROPERTIES = 11;

  // Define a queue property structure and the structures needed to initialize it.
  MQQUEUEPROPS   QueueProps;
  MQPROPVARIANT  aQueuePropVar[NUMBEROFPROPERTIES];
  QUEUEPROPID    aQueuePropId[NUMBEROFPROPERTIES];
  HRESULT        aQueueStatus[NUMBEROFPROPERTIES];
  HRESULT        hr = MQ_OK;
  
  // Set queue path.
  DWORD cPropId = 0;
  aQueuePropId[cPropId] = PROPID_Q_PATHNAME;
  aQueuePropVar[cPropId].vt = VT_LPWSTR;
  aQueuePropVar[cPropId].pwszVal = wszPathName;
  cPropId++;

  // Set queue label.
  WCHAR wszLabel[MQ_MAX_Q_LABEL_LEN] = L"public non tran";
  aQueuePropId[cPropId] = PROPID_Q_LABEL;
  aQueuePropVar[cPropId].vt = VT_LPWSTR;
  aQueuePropVar[cPropId].pwszVal = wszLabel;
  cPropId++;

  // Set queue authenticate.
  aQueuePropId[cPropId] = PROPID_Q_AUTHENTICATE;
  aQueuePropVar[cPropId].vt = VT_UI1;
  aQueuePropVar[cPropId].bVal = MQ_AUTHENTICATE_NONE;//The default. The queue accepts authenticated and non-authenticated messages.
        //MQ_AUTHENTICATE; //The queue only accepts authenticated messages.
  cPropId++;

  // Set queue base priority. Applies only to public queues.
  aQueuePropId[cPropId] = PROPID_Q_BASEPRIORITY;
  aQueuePropVar[cPropId].vt = VT_I2;
  aQueuePropVar[cPropId].iVal = 1; //default is 0
  cPropId++;

  // Set queue privacy level.
  aQueuePropId[cPropId] = PROPID_Q_PRIV_LEVEL;
  aQueuePropVar[cPropId].vt = VT_UI4;
  aQueuePropVar[cPropId].ulVal = MQ_PRIV_LEVEL_NONE;//The queue accepts only non-private (clear) messages.
         //MQ_PRIV_LEVEL_BODY;//The queue accepts only private (encrypted) messages.
         //MQ_PRIV_LEVEL_OPTIONAL;//The default. The queue does not enforce privacy. It accepts private (encrypted) messages and non-private (clear) messages.
  cPropId++;

  // Set queue journal.
  aQueuePropId[cPropId] = PROPID_Q_JOURNAL;
  aQueuePropVar[cPropId].vt = VT_UI1;
  aQueuePropVar[cPropId].bVal = MQ_JOURNAL;
        //MQ_JOURNAL_NONE;
  cPropId++;

  // Set queue storage size in KB.
  aQueuePropId[cPropId] = PROPID_Q_QUOTA;
  aQueuePropVar[cPropId].vt = VT_UI4;
  aQueuePropVar[cPropId].ulVal = 1000;
  cPropId++;

  // Set queue journal storage size in KB.
  aQueuePropId[cPropId] = PROPID_Q_JOURNAL_QUOTA;
  aQueuePropVar[cPropId].vt = VT_UI4;
  aQueuePropVar[cPropId].ulVal = 1000;
  cPropId++;

   //set broadcast address, not set for transactional queues.
   WCHAR AddressBuffer[]=L"224.0.0.255:80";
   aQueuePropId[cPropId] = PROPID_Q_MULTICAST_ADDRESS;    
   aQueuePropVar[cPropId].vt = VT_EMPTY //not set multicast address. 
   //aQueuePropVar[cPropId].vt = VT_LPWSTR;             
   //aQueuePropVar[cPropId].pwszVal = AddressBuffer;       
   cPropId++;

  // set if the queue is transactional queue
  aQueuePropId[cPropId] = PROPID_Q_TRANSACTION;    
  aQueuePropVar[cPropId].vt = VT_UI1;            
  aQueuePropVar[cPropId].bVal = //MQ_TRANSACTIONAL; 
        MQ_TRANSACTIONAL_NONE;
  cPropId++;

  aQueuePropId[cPropId] = PROPID_Q_TYPE;                
  aQueuePropVar[cPropId].vt = VT_CLSID;              
  aQueuePropVar[cPropId].puuid = (CLSID*)(&GUID_NULL); 
  cPropId++;

  // Initialize the MQQUEUEPROPS structure.
  QueueProps.cProp = cPropId;               // Number of properties
  QueueProps.aPropID = aQueuePropId;        // IDs of the queue properties
  QueueProps.aPropVar = aQueuePropVar;      // Values of the queue properties
  QueueProps.aStatus = aQueueStatus;        // Pointer to the return status


  // Call MQCreateQueue to create the queue.
  WCHAR wszFormatNameBuffer[BUFLEN];
  DWORD dwFormatNameBufferLength = BUFLEN;
  hr = MQCreateQueue(NULL,         // Security descriptor
                     &QueueProps,                 // Address of queue property structure
                     wszOutFormatName,         // Pointer to format name buffer
                     pdwOutFormatNameLength);  // Pointer to receive the queue's format name length in Unicode characters not bytes.

  return hr;
}

 

 wchar_t formattedQueueName[256]; 
 QUEUEHANDLE m_hQueue;
 CreatePublicNontranMSMQQueue(L".\\pubnontran",formattedQueueName,&bufferLength);

3.创建Public transactional Queue

 创建Public transactional Queue与Public non-transactional Queue相比，需要把PROPID_Q_TRANSACTION属性设置为MQ_TRANSACTIONAL，且不应设置PROPID_Q_MULTICAST_ADDRESS

   //set broadcast address, not set for transactional queues.
   aQueuePropId[cPropId] = PROPID_Q_MULTICAST_ADDRESS;    
   aQueuePropVar[cPropId].vt = VT_EMPTY;
   cPropId++;

  // set if the queue is transactional queue
  aQueuePropId[cPropId] = PROPID_Q_TRANSACTION;    
  aQueuePropVar[cPropId].vt = VT_UI1;            
  aQueuePropVar[cPropId].bVal = MQ_TRANSACTIONAL; 
        //MQ_TRANSACTIONAL_NONE;
  cPropId++;

 

 4.创建Private Non-transactional Queue

创建Private Non-transactional Queue与Public Non-transactional Queue相比一个是对PROPID_Q_BASEPRIORITY属性的设置将无效。另一个就是pathname里面需要加private$符号来标明这是个private的Queue。

 wchar_t formattedQueueName[256]; 
 QUEUEHANDLE m_hQueue;
 CreatePrivateNontranMSMQQueue(L".\\private$\\prinontran",formattedQueueName,&bufferLength);

 
5.创建Private transactional Queue

创建方法参见2,3,4条。