MessageQueue.PeekByLookupId Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eingeführt in MSMQ 3.0. Sieht eine bestimmte Meldung in der Warteschlange ein. Die Meldung kann anhand eines Suchbezeichners oder anhand der Position am Anfang oder am Ende der Warteschlange angegeben werden.
Überlädt
| PeekByLookupId(Int64) |
Eingeführt in MSMQ 3.0. Sieht die Meldung ein, die dem angegebenen Suchbezeichner in einer nicht transaktionalen Warteschlange entspricht. |
| PeekByLookupId(MessageLookupAction, Int64) |
Eingeführt in MSMQ 3.0. Sieht eine bestimmte Meldung in der Warteschlange ein. Die Meldung kann anhand eines Suchbezeichners oder anhand der Position am Anfang oder am Ende der Warteschlange angegeben werden. |
PeekByLookupId(Int64)
Eingeführt in MSMQ 3.0. Sieht die Meldung ein, die dem angegebenen Suchbezeichner in einer nicht transaktionalen Warteschlange entspricht.
public:
System::Messaging::Message ^ PeekByLookupId(long lookupId);public System.Messaging.Message PeekByLookupId (long lookupId);member this.PeekByLookupId : int64 -> System.Messaging.MessagePublic Function PeekByLookupId (lookupId As Long) As MessageParameter
Gibt zurück
Die Message, deren LookupId-Eigenschaft dem übergebenen lookupId-Parameter entspricht.
Ausnahmen
MSMQ 3.0 ist nicht installiert.
Die Meldung mit der angegebenen lookupId wurde nicht gefunden.
Fehler beim Zugriff auf eine Message Queuing-Methode.
Hinweise
Verwenden Sie diese Methode, um eine Nachricht mit einem bekannten Suchbezeichner zu lesen, ohne sie aus der Warteschlange zu entfernen. Diese Methode löst sofort eine Ausnahme aus, wenn sich die Nachricht nicht in der Warteschlange befindet.
Die LookupId -Eigenschaft einer Nachricht ist für die Warteschlange eindeutig, in der sich die Nachricht befindet, sodass in der Warteschlange höchstens eine Nachricht vorhanden ist, die dem angegebenen lookupId Parameter entspricht.
Verwenden Sie die -Methode, um eine Nachricht mit einem angegebenen Nachschlagebezeichner zu lesen und aus der ReceiveByLookupId Warteschlange zu entfernen.
Die folgende Tabelle zeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.
| Arbeitsgruppenmodus | Verfügbar |
|---|---|
| Lokalem Computer | Ja |
| Name des lokalen Computers und direktes Format | Ja |
| Remotecomputer | Nein |
| Name des Remotecomputers und des direkten Formats | Ja |
Weitere Informationen
Gilt für:
PeekByLookupId(MessageLookupAction, Int64)
Eingeführt in MSMQ 3.0. Sieht eine bestimmte Meldung in der Warteschlange ein. Die Meldung kann anhand eines Suchbezeichners oder anhand der Position am Anfang oder am Ende der Warteschlange angegeben werden.
public:
System::Messaging::Message ^ PeekByLookupId(System::Messaging::MessageLookupAction action, long lookupId);public System.Messaging.Message PeekByLookupId (System.Messaging.MessageLookupAction action, long lookupId);member this.PeekByLookupId : System.Messaging.MessageLookupAction * int64 -> System.Messaging.MessagePublic Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As MessageParameter
- action
- MessageLookupAction
Einer der MessageLookupAction-Werte, der angibt, wie die Meldung in der Warteschlange gelesen wird. Geben Sie eine der folgenden Optionen an:
MessageLookupAction.Current: Sieht die durch die lookupId angegebene Meldung ein.
MessageLookupAction.Next: Sieht die Meldung ein, die auf die anhand der lookupId angegebene Meldung folgt.
MessageLookupAction.Previous: Sieht die Meldung ein, die der anhand der lookupId angegebenen Meldung vorausgeht.
MessageLookupAction.First: Sieht die erste Meldung in der Warteschlange ein. Der lookupId-Parameter muss auf 0 festgelegt werden.
MessageLookupAction.Last: Sieht die letzte Meldung in der Warteschlange ein. Der lookupId-Parameter muss auf 0 festgelegt werden.
- lookupId
- Int64
Die LookupId der einzusehenden Meldung, andernfalls 0 (null). 0 wird beim Zugreifen auf die erste oder letzte Meldung in die Warteschlange verwendet.
Gibt zurück
Die durch den übergebenen action-Parameter und lookupId-Parameter angegebene Message.
Ausnahmen
MSMQ 3.0 ist nicht installiert.
Die Meldung mit der angegebenen lookupId wurde nicht gefunden.
Fehler beim Zugriff auf eine Message Queuing-Methode.
Der action-Parameter ist keiner der MessageLookupAction-Member.
Hinweise
Verwenden Sie diese Methode, um eine Nachricht mit einem bekannten Suchbezeichner zu lesen, ohne sie aus der Warteschlange zu entfernen. Diese Methode löst sofort eine Ausnahme aus, wenn sich die Nachricht nicht in der Warteschlange befindet.
Die LookupId -Eigenschaft einer Nachricht ist für die Warteschlange eindeutig, in der sich die Nachricht befindet, sodass in der Warteschlange höchstens eine Nachricht vorhanden ist, die dem angegebenen lookupId Parameter entspricht.
Verwenden Sie die -Methode, um eine Nachricht mit einem angegebenen Bezeichner zu lesen und aus der ReceiveByLookupId Warteschlange zu entfernen.
Die folgende Tabelle zeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.
| Arbeitsgruppenmodus | Verfügbar |
|---|---|
| Lokalem Computer | Ja |
| Name des lokalen Computers und direktes Format | Ja |
| Remotecomputer | Nein |
| Name des Remotecomputers und des direkten Formats | Ja |
