MessageQueue.GetMessageEnumerator2 Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee maakt u een enumerator-object voor alle berichten in de wachtrij.
public:
System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();
public System.Messaging.MessageEnumerator GetMessageEnumerator2();
member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumerator
Public Function GetMessageEnumerator2 () As MessageEnumerator
Retouren
De MessageEnumerator berichten die zich in de wachtrij bevinden.
Opmerkingen
GetMessageEnumerator2 maakt een dynamische lijst met alle berichten in een wachtrij. U kunt het bericht verwijderen uit de wachtrij op de huidige positie van de enumerator door aan te roepen RemoveCurrent voor de MessageEnumerator retournering GetMessageEnumerator2 .
Omdat de cursor is gekoppeld aan de dynamische lijst met berichten in de wachtrij, weerspiegelt de opsomming alle wijzigingen die u aanbrengt in de berichten in de wachtrij, als het bericht zich buiten de huidige cursorpositie bevindt. De enumerator heeft bijvoorbeeld automatisch toegang tot een bericht met een lagere prioriteit dat buiten de huidige positie van de cursor wordt geplaatst, maar niet tot een bericht met een hogere prioriteit dat vóór die positie is ingevoegd. U kunt de opsomming echter opnieuw instellen, waardoor de cursor weer naar het begin van de lijst wordt verplaatst door het aanroepen van Reset de MessageEnumeratorlijst.
De volgorde van de berichten in de opsomming weerspiegelt hun volgorde in de wachtrij, zodat berichten met een hogere prioriteit worden weergegeven voordat berichten met een lagere prioriteit worden weergegeven.
Als u een statische momentopname van de berichten in de wachtrij wilt in plaats van een dynamische verbinding met deze berichten, roept u het aan GetAllMessages. Deze methode retourneert een matrix met Message objecten, die de berichten vertegenwoordigen op het moment dat de methode werd aangeroepen.
In de volgende tabel ziet u of deze methode beschikbaar is in verschillende werkgroepmodi.
| Werkgroepmodus | Available |
|---|---|
| Lokale computer | Ja |
| Naam van lokale computer en directe indeling | Ja |
| Externe computer | Ja |
| Naam van externe computer en directe indeling | Ja |