[ Home |
Alpha index |
Topic index |
Tutorials |
Download |
Feedback ]
The OS/2 API Project
WinCreateMsgQueue
[ Syntax |
Params |
Returns |
Include |
Usage |
Structs |
Gotchas |
Code |
Also ]
Syntax
hmq = WinCreateMsgQueue( hab,
maxMsg );
Parameters
- HAB hab (input)
- Anchor block of calling thread (from WinInitialize or
WinQueryAnchorBlock).
- LONG maxMsg (input)
- The number of messages the queue can hold. Pass 0 for system default.
Returns
- HMQ hmq
- Handle to the newly created message queue. NULLHANDLE is returned if
there was an error. WinGetLastError will return one of:
| 0x100A |
PMERR_RESOURCE_NOT_FOUND |
| 0x1011 |
PMERR_HEAP_OUT_OF_MEMORY |
| 0x1012 |
PMERR_HEAP_MAX_SIZE_REACHED |
| 0x1018 |
PMERR_QUEUE_TOO_LARGE |
| 0x1051 |
PMERR_NOT_IN_A_PM_SESSION |
| 0x1052 |
PMERR_MSG_QUEUE_ALREADY_EXISTS |
Include Info
#define INCL_WINMESSAGEMGR
#include <os2.h>
Usage Explanation
After calling WinInitialize, you must call this function if your thread
needs to respond to messages. Save the handle, as other functions need it
as input.
Relevant Structures
Gotchas
Sample Code
<![CDATA[
#define INCL_WINMESSAGEMGR
#include <os2.h>
HAB hab;
ULONG flOptions = 0L;
HMQ hmq;
hab=WinInitialize(flOptions);
hmq=WinCreateMsgQueue(hab, 0L);
if (hmq) {
.
.
.
}
]]>
See Also
WinDestroyMsgQueue, WinPostMessage, WinSendMessage
Author
Carsten Whimster -
bcrwhims@uwaterloo.ca
Additions
Last modified April 30/1996
Please send all errors, comments, and suggestions to:
timur@vnet.ibm.com
The OS/2 API Project |
WinCreateMsgQueue |