MessageQueue.PeekByLookupId 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
MSMQ 3.0에서 도입되었습니다. 큐의 특정 메시지를 피킹합니다. 메시지는 조회 식별자로 지정하거나 큐의 앞이나 뒤와 같은 위치로 지정할 수 있습니다.
오버로드
| PeekByLookupId(Int64) |
MSMQ 3.0에서 도입되었습니다. 비트랜잭션 큐에서 지정된 조회 식별자를 갖는 메시지를 피킹합니다. |
| PeekByLookupId(MessageLookupAction, Int64) |
MSMQ 3.0에서 도입되었습니다. 큐의 특정 메시지를 피킹합니다. 메시지는 조회 식별자로 지정하거나 큐의 앞이나 뒤와 같은 위치로 지정할 수 있습니다. |
PeekByLookupId(Int64)
MSMQ 3.0에서 도입되었습니다. 비트랜잭션 큐에서 지정된 조회 식별자를 갖는 메시지를 피킹합니다.
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 Message매개 변수
반환
전달된 lookupId 매개 변수와 Message 속성이 일치하는 LookupId를 반환합니다.
예외
MSMQ 3.0이 설치되어 있지 않은 경우
지정된 lookupId의 메시지를 찾을 수 없는 경우
메시지 큐 메서드에 액세스하는 동안 오류가 발생한 경우
설명
이 메서드를 사용하여 큐에서 메시지를 제거하지 않고 알려진 조회 식별자가 있는 메시지를 읽습니다. 이 메서드는 메시지가 큐에 없는 경우 즉시 예외를 throw합니다.
메시지의 속성은 LookupId 메시지가 있는 큐에 고유하므로 큐에 지정된 lookupId 매개 변수와 일치하는 최대 하나의 메시지가 있습니다.
지정된 조회 식별자가 있는 메시지를 읽고 큐에서 제거하려면 메서드를 ReceiveByLookupId 사용합니다.
다음 표에서는 이 메서드를 다양한 작업 그룹 모드에서 사용할 수 있는지 여부를 보여 줍니다.
| 작업 그룹 모드 | 사용 가능 |
|---|---|
| 수집 | Yes |
| 로컬 컴퓨터 및 직접 형식 이름 | Yes |
| 원격 컴퓨터 | No |
| 원격 컴퓨터 및 직접 형식 이름 | Yes |
추가 정보
적용 대상
PeekByLookupId(MessageLookupAction, Int64)
MSMQ 3.0에서 도입되었습니다. 큐의 특정 메시지를 피킹합니다. 메시지는 조회 식별자로 지정하거나 큐의 앞이나 뒤와 같은 위치로 지정할 수 있습니다.
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 Message매개 변수
- action
- MessageLookupAction
큐에서 메시지를 읽는 방법을 지정하는 MessageLookupAction 값 중 하나입니다. 다음 중 하나를 지정합니다.
MessageLookupAction.Current: lookupId로 지정된 메시지를 피킹합니다.
MessageLookupAction.Next: lookupId로 지정된 메시지의 뒤에 있는 메시지를 피킹합니다.
MessageLookupAction.Previous: lookupId로 지정된 메시지의 앞에 있는 메시지를 피킹합니다.
MessageLookupAction.First: 큐에 있는 첫 번째 메시지를 피킹합니다. lookupId 매개 변수는 0으로 설정되어야 합니다.
MessageLookupAction.Last: 큐에 있는 마지막 메시지를 피킹합니다. lookupId 매개 변수는 0으로 설정되어야 합니다.
반환
전달된 action 및 lookupId 매개 변수로 지정된 Message입니다.
예외
MSMQ 3.0이 설치되어 있지 않은 경우
지정된 lookupId의 메시지를 찾을 수 없는 경우
메시지 큐 메서드에 액세스하는 동안 오류가 발생한 경우
action 매개 변수가 MessageLookupAction 멤버 중 하나가 아닌 경우
설명
이 메서드를 사용하여 큐에서 메시지를 제거하지 않고 알려진 조회 식별자가 있는 메시지를 읽습니다. 이 메서드는 메시지가 큐에 없는 경우 즉시 예외를 throw합니다.
메시지의 속성은 LookupId 메시지가 있는 큐에 고유하므로 큐에 지정된 lookupId 매개 변수와 일치하는 최대 하나의 메시지가 있습니다.
지정된 식별자가 있는 메시지를 읽고 큐에서 제거하려면 메서드를 ReceiveByLookupId 사용합니다.
다음 표에서는 이 메서드를 다양한 작업 그룹 모드에서 사용할 수 있는지 여부를 보여 줍니다.
| 작업 그룹 모드 | 사용 가능 |
|---|---|
| 수집 | Yes |
| 로컬 컴퓨터 및 직접 형식 이름 | Yes |
| 원격 컴퓨터 | No |
| 원격 컴퓨터 및 직접 형식 이름 | Yes |
추가 정보
적용 대상
.NET