Updated: July 19, 2016

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 MQFreeMemory function frees memory allocated by Message Queuing.

VOID MQFreeMemory(  
  PVOID pvMemory    


[in] Pointer to the memory to be freed.

Whenever an application passes VT_NULL in an aPropVar array and Message Queuing allocates memory for the returned property value (for example, puuid and pwszVal), MQFreeMemory must be called.

For MQLocateNext, all properties whose values returned by Message Queuing are stored outside aPropVar must also be freed using MQFreeMemory.

Example Code

The following code examples are included in Using Message Queuing.

For an example ofSee
Using MQFreeMemory to free memory allocated for a stringC/C++ Code Example: Retrieving PROPID_Q_LABEL

 C/C++ Code Example: Retrieving PROPID_Q_MULTICAST_ADDRESS

 C/C++ Code Example: Retrieving PROPID_Q_PATHNAME

 C/C++ Code Example: Retrieving PROPID_Q_PATHNAME_DNS
Using MQFreeMemory to free memory allocated for an array of stringsC/C++ Code Example: Obtaining a List of Private Queues

Windows NT/2000/XP: Included in Windows NT 4.0 SP3 and later.

Windows 95/98/Me: Included in Windows 95 and later.

Header: Declared in Mq.h.

Library: Use Mqrt.lib.

Message Queuing Functions

Community Additions