MessageQueue.Purge メソッド

キューに含まれるすべてのメッセージを削除します。

Public Sub Purge()
[C#]
public void Purge();
[C++]
public: void Purge();
[JScript]
public function Purge();

例外

例外の種類	条件
MessageQueueException	メッセージ キューの API にアクセスしたときにエラーが発生しました。

解説

キューを削除すると、メッセージ キューはキュー変更フラグを設定します。これは、 LastModifyTime プロパティに影響を与えます。キューから削除されたメッセージは失われます。配信不能キューや履歴キューには送信されません。

このメソッドが各種のワークグループ モードで使用できるかどうかを次の表に示します。

ワークグループ モード	使用可否
ローカル コンピュータ	はい
ローカル コンピュータ + 直接書式名	はい
リモート コンピュータ	いいえ
リモート コンピュータ + 直接書式名	はい

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

• 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用

参照

MessageQueue クラス | MessageQueue メンバ | System.Messaging 名前空間 | Close | Refresh