函數 | 說明 |
---|---|
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 函數。