関数 | 説明 |
---|---|
xmsQueueBrowserClose | キュー・ブラウザーを閉じます。 |
xmsQueueBrowserGetEnumeration | キュー上のメッセージのリストを取得します。 |
xmsQueueBrowserGetMessageSelector | キュー・ブラウザーのメッセージ・セレクターを取得します。 |
xmsQueueBrowserGetQueue | キュー・ブラウザーに関連付けられたキューを取得します。 |
xmsRC xmsQueueBrowserGetEnumeration(xmsHQueueBrowser browser, xmsHIterator *iterator, xmsHErrorBlock errorBlock);
この関数は、Message オブジェクトのリストをカプセル化するイテレーターを戻します。リスト内の Message オブジェクトの順序は、メッセージがキューから取り出される順序と同じです。アプリケーションは、そのイテレーターを使用して、各メッセージを順番に参照することができます。
イテレーターは、メッセージがキューに置かれたとき、およびキューから除去されたときに動的に更新されます。アプリケーションがキュー上の次のメッセージを参照するために xmsIteratorGetNext() を呼び出すたびに、戻されるメッセージはキューの現在の内容を反映しています。
アプリケーションが、特定のキュー・ブラウザーに対してこの関数を複数回呼び出した場合、呼び出すたびに新しいイテレーターが戻されます。そのため、アプリケーションは、複数のイテレーターを使用してキュー上のメッセージを参照し、キュー内の複数の位置を維持することができます。
xmsRC xmsQueueBrowserGetMessageSelector(xmsHQueueBrowser browser, xmsCHAR *messageSelector, xmsINT length, xmsINT *actualLength, xmsHErrorBlock errorBlock);
この関数の使用方法について詳しくは、値によりストリングを戻す C 関数を参照してください。