Share via


Message.LookupId 속성

정의

MSMQ 3.0에서 도입되었습니다. 메시지의 조회 식별자를 가져옵니다.

public:
 property long LookupId { long get(); };
public long LookupId { get; }
member this.LookupId : int64
Public ReadOnly Property LookupId As Long

속성 값

메시지 큐에서 생성되었으며 해당 메시지가 있는 큐에 고유한 메시지 조회 식별자입니다.

예외

MSMQ 3.0이 설치되어 있지 않은 경우

메시지를 보내지 않았습니다. 이 속성은 큐에서 검색된 메시지에서만 읽을 수 있습니다.

또는

메시지 큐가 LookupId 속성을 무시하도록 필터링된 경우

설명

LookupId 속성은 메시지의 조회 식별자에 대 한 읽기 전용 액세스를 제공 합니다. MSMQ 3.0에서 도입 된 조회 식별자는 메시지 큐에서 생성 되 고 메시지 큐에 배치 되 면 각 메시지에 할당 되는 64 비트 식별자가입니다. 조회 식별자는 메시지를 보낼 때 생성 되는 메시지 식별자로 같지는 않습니다.

메시지 큐는 커넥터 및 보내는 큐 시스템에서 생성 된 저널에 배달 못 한 편지, 뿐만 아니라 대상 애플리케이션 생성, 관리 및 보고서 큐를 포함 하 여 모든 큐에 배치 되는 모든 메시지에 대 한 조회 식별자를 생성 합니다. 즉, 보내는 애플리케이션에서 보내고 메시지 큐에서 메시지를 모두 포함 됩니다. 조회 식별자는 큐에 고유 하며 큐 외부에서는 의미가 없습니다.

여러 대상 큐로 메시지를 보내는 경우, 컴퓨터 저널 또는 저널 큐에서 메시지의 복사본이 저장 되는 경우 각 큐에 배치 되는 경우 메시지의 각 복사본이 자체 조회 식별자를 해야 합니다.

LookupId 속성 큐에서 검색 된 메시지 에서만 읽을 수 있습니다.

조회 식별자를 큐에서 특정 메시지를 읽는 데 사용 됩니다. 메시지의 조회 식별자가 확인 되 면 수신 애플리케이션이 호출할 수는 PeekByLookupId 또는 ReceiveByLookupId 해당 메시지에 직접 이동 하 고 보거나 큐 맨 앞에 시작 해야 하는 커서와 달리 큐에서 검색 하는 함수 및 큐의 끝 쪽으로 이동

큐의 메시지 조회 식별자를 가져오는 하는 것은 애플리케이션의 책임입니다. 조회 식별자를 가져오는 한 가지 가능한 방법 큐에 배치 될 때 각 메시지의 식별자를 캐시 하는 구성 요소를 호출 하는 대상 큐에 대 한 트리거를 만드는 것입니다.

적용 대상

추가 정보