Microsoft Windows CE 3.0  

Creating a Queue

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

You create a queue by calling the MQCreateQueuefunction. Note that in Windows CE, MQCreateQueuecan create only a local private queue.

Windows CE does not require connection to a domain controller. Instead, it uses a peer-to-peer configuration that does not require a directory-service interface such as Microsoft Active Directory. Because public queues make their existence known through the Active Directory, you cannot create public queues in Windows CE.

Windows CE does not support ACL-based security. Set the MQCreateQueue pSecurityDescriptorparameter to NULL.

The following properties specified with the MQCreateQueue pQueuePropsparameter have limited support on Windows CE:

Property Windows CE support
PROPID_Q_AUTHENTICATE Only MQ_AUTHENTICATE_NONE is enabled.
PROPID_Q_BASEPRIORITY Accepted but not useful because there is no way to query it from outside.
PROPID_Q_PATHNAME Only private path names are enabled.
PROPID_Q_PRIV_LEVEL Only MQ_PRIV_LEVEL_NONE is enabled.
PROPID_Q_TRANSACTION Only MQ_TRANSACTIONAL_NONE is enabled.
PROPID_Q_TYPE Accepted but useless since there is no way to query it from outside.

By default, the Windows CE implementation of MQCreateQueuecreates queues that have no journal. To create a queue that has a journal, set the PROPID_Q_JOURNAL to MQ_JOURNAL. Journaling will automatically be turned on in the new queue. To turn journaling off, call MQSetQueueProperties. Note that calling MQSetQueuePropertiesto activate message journaling on a queue that was created without a journal will fail.