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.
A version of this page is also available for
4/8/2010

This function opens a handle to an existing message queue based on a message queue handle.

Syntax 

HANDLE OpenMsgQueue(
  HANDLE 
hSrcProc,
  HANDLE 
hMsgQ,
  LPMSGQUEUEOPTIONS 
lpOptions
);

Parameters

hSrcProc

[in] Handle to a source process that owns the hMsgQmessage queue handle.

hMsgQ

[in] Event handle to a message queue returned by the CreateMsgQueuefunction.

lpOptions

[in] Pointer to an MSGQUEUEOPTIONSstructure that sets the properties of the message queue.

Return Value

A handle to a message queue indicates success. NULL indicates that the queue could not be opened.

Remarks

Use the CloseMsgQueuefunction to close the handle returned by the OpenMsgQueuefunction. When called, the OpenMsgQueuefunction checks only the values of the dwSizeand bReadAccessmembers of the lpOptionsparameter.

Requirements

Header msgqueue.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also