Deletes all the messages contained in the queue.
[Visual Basic] Public Sub Purge() [C#] public void Purge(); [C++] public: void Purge(); [JScript] public function Purge();
|MessageQueueException||An error occurred when accessing a Message Queuing API.|
Purging the queue causes Message Queuing to set the queue modification flag, which affects the LastModifyTime property. Messages that are purged from the queue are lost; they are not sent to the dead-letter queue or the journal queue.
The following table shows whether this method is available in various Workgroup modes.
|Local computer + direct format name||Yes|
|Remote computer + direct format name||Yes|
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
.NET Framework Security:
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries From Partially Trusted Code