WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 운영 체제: Linux, Windows

QueueBrowser

응용프로그램은 대기열 브라우저를 사용하여 대기열의 메시지를 제거하지 않고 찾아봅니다.

상속 계층 구조:
xms::PropertyContext
   |
   +----xms::QueueBrowser

메소드

메소드 요약:
메소드 설명
close 대기열 브라우저를 닫습니다.
getEnumeration 대기열에 있는 메시지 목록을 가져옵니다.
getHandle C 응용프로그램이 대기열 브라우저에 액세스하는 데 사용하는 핸들을 가져옵니다.
getMessageSelector 대기열 브라우저에 대한 메시지 선택자를 가져옵니다.
getQueue 대기열 브라우저와 연관된 대기열을 가져옵니다.
isNull QueueBrowser 오브젝트가 널 오브젝트인지 여부를 판별합니다.

close – 대기열 브라우저 닫기

인터페이스:
xmsVOID close();

대기열 브라우저를 닫습니다.

응용프로그램이 이미 닫힌 대기열 브라우저를 닫으려고 하면 호출이 무시됩니다.

매개변수:
없음
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

getEnumeration – 메시지 가져오기

인터페이스:
Iterator getEnumeration() const;

대기열에 있는 메시지 목록을 가져옵니다.

이 메소드는 Message 오브젝트의 목록을 캡슐화하는 반복기를 리턴합니다. 목록에 있는 Message 오브젝트의 순서는 대기열에서 메시지를 검색하는 순서와 같습니다. 응용프로그램은 반복기를 사용하여 각 메시지를 찾아볼 수 있습니다.

반복기는 메시지가 대기열에 넣어지고 대기열에서 제거될 때 동적으로 갱신됩니다. 응용프로그램이 Iterator.getNext()를 호출하여 대기열의 다음 메시지를 찾아볼 때마다 리턴되는 메시지는 대기열의 현재 컨텐츠를 반영합니다.

응용프로그램이 지정된 대기열 브라우저에 대해 이 메소드를 두 번 이상 호출할 경우 호출 시마다 새 반복기가 리턴됩니다. 그러므로 응용프로그램은 둘 이상의 반복기를 사용하여 대기열의 메시지를 찾아보고 대기열 내에 여러 위치를 유지합니다.

매개변수:
없음
리턴값:
Iterator 오브젝트입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 핸들 가져오기

인터페이스:
xmsHQueueBrowser getHandle() const;

C 응용프로그램이 대기열 브라우저에 액세스하는 데 사용하는 핸들을 가져옵니다.

매개변수:
없음
리턴값:
대기열 브라우저의 핸들입니다.
스레드 컨텍스트:
임의
예외:
  • XMS_X_GENERAL_EXCEPTION

getMessageSelector – 메시지 선택자 가져오기

인터페이스:
String getMessageSelector() const;

대기열 브라우저에 대한 메시지 선택자를 가져옵니다.

매개변수:
없음
리턴값:
메시지 선택자 표현식을 캡슐화하는 String 오브젝트입니다. 데이터 변환이 필수인 경우 이 매개변수는 변환 후 메시지 선택자 표현식입니다. 대기열 브라우저에 목적지가 없으면 이 메소드는 널 String 오브젝트를 리턴합니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getQueue – 대기열 가져오기

인터페이스:
Destination getQueue() const;

대기열 브라우저와 연관된 대기열을 가져옵니다.

매개변수:
없음
리턴값:
대기열을 나타내는 Destination 오브젝트입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

isNull – 널 여부 확인

인터페이스:
xmsBOOL isNull() const;

QueueBrowser 오브젝트가 널 오브젝트인지 여부를 판별합니다.

매개변수:
없음
리턴값:
  • xmsTRUE - QueueBrowser 오브젝트가 널 오브젝트인 경우
  • xmsFALSE - QueueBrowser 오브젝트가 널 오브젝트가 아닌 경우
스레드 컨텍스트:
임의
예외:
  • XMS_X_GENERAL_EXCEPTION

상속된 메소드


Reference topic

이용약관 | 피드백

Timestamp icon마지막 갱신 날짜: 3 Mar 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
이 Information Center는 Eclipse 기술 기반입니다. (http://www.eclipse.org 웹 사이트 참조)