MessageQueue.GetMessageEnumerator2 Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Tworzy obiekt modułu wyliczającego dla wszystkich komunikatów w kolejce.
public:
System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();
public System.Messaging.MessageEnumerator GetMessageEnumerator2 ();
member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumerator
Public Function GetMessageEnumerator2 () As MessageEnumerator
Zwraca
Przechowujące MessageEnumerator komunikaty zawarte w kolejce.
Uwagi
GetMessageEnumerator2 Tworzy dynamiczną listę wszystkich komunikatów w kolejce. Komunikat można usunąć z kolejki w bieżącej pozycji modułu wyliczającego, wywołując RemoveCurrent polecenie zwracania MessageEnumeratorGetMessageEnumerator2 .
Ponieważ kursor jest skojarzony z dynamiczną listą komunikatów w kolejce, wyliczenie odzwierciedla wszelkie modyfikacje wprowadzone w komunikatach w kolejce, jeśli komunikat znajduje się poza bieżącym położeniem kursora. Na przykład moduł wyliczający może automatycznie uzyskać dostęp do komunikatu o niższym priorytcie umieszczonym poza bieżącą pozycją kursora, ale nie komunikatem o wyższym priorytetzie wstawionym przed tym położeniem. Można jednak zresetować wyliczenie, przenosząc kursor z powrotem na początek listy, wywołując polecenie ResetMessageEnumerator.
Kolejność komunikatów w wyliczenie odzwierciedla ich kolejność w kolejce, więc komunikaty o wyższym priorytetu będą wyświetlane przed niższym priorytetem.
Jeśli chcesz, aby statyczna migawka komunikatów w kolejce, a nie połączenie dynamiczne z nimi, wywołaj metodę GetAllMessages. Ta metoda zwraca tablicę Message obiektów, które reprezentują komunikaty w momencie wywołania metody.
W poniższej tabeli przedstawiono, czy ta metoda jest dostępna w różnych trybach grupy roboczej.
Tryb grupy roboczej | Dostępne |
---|---|
Komputer lokalny | Tak |
Komputer lokalny i nazwa formatu bezpośredniego | Tak |
Komputer zdalny | Tak |
Nazwa komputera zdalnego i formatu bezpośredniego | Tak |