C 응용프로그램은 오브젝트 핸들을 사용하여 오브젝트에 액세스합니다. 오브젝트 핸들에는 두 가지 종류가 있습니다. 하나는 오브젝트의 유형과 관련된 데이터 유형이고 다른 종류는 해당 데이터 유형이 오브젝트의 유형과 관련되지 않는 일반 오브젝트 핸들입니다.
C 응용프로그램이 함수를 호출하여 오브젝트를 작성하면 XMS 오브젝트를 내부에 저장하고 오브젝트의 핸들을 응용프로그램으로 리턴합니다. 그러면 응용프로그램은 연속적으로 핸들을 사용하여 오브젝트에 액세스할 수 있습니다.
모든 오브젝트 핸들에는 오브젝트의 유형과 관련된 데이터 유형이 있습니다. 표 1 에는 각 오브젝트 유형의 오브젝트 핸들 데이터 유형이 설명되어 있습니다. BytesMessage, MapMessage, ObjectMessage, StreamMessage, TextMessage 및 Message 오브젝트에는 모두 같은 데이터 유형 xmsHMsg의 핸들이 있습니다. 메시지의 핸들 사용 방법에 대한 자세한 정보는 XMS 메시지 본문을 참조하십시오.
오브젝트의 유형 | 오브젝트 핸들 데이터 유형 |
---|---|
Connection | xmsHConn |
ConnectionFactory | xmsHConnFact |
ConnectionMetaData | xmsHConnMetaData |
Destination | xmsHDest |
ErrorBlock | xmsHErrorBlock |
InitialContext | xmsHInitialContext |
Iterator | xmsHIterator |
Message, BytesMessage, MapMessage, ObjectMessage, StreamMessage 및 TextMessage | xmsHMsg |
MessageConsumer | xmsHMsgConsumer |
MessageProducer | xmsHMsgProducer |
등록 정보 | xmsHProperty |
QueueBrowser | xmsHQueueBrowser |
Requestor | xmsHRequestor |
Session | xmsHSess |
특정 함수는 함수가 작성한 오브젝트의 유형과 관련되지 않은 일반 오브젝트 핸들을 리턴합니다. 일반 오브젝트 핸들에는 데이터 유형 xmsHObj가 있습니다.
응용프로그램이 이러한 함수 중 하나에서 일반 오브젝트 핸들을 수신하면 응용프로그램은 PropertyContext 클래스의 xmsGetHandleTypeId() 함수를 호출하여 오브젝트의 유형과 관련된 오브젝트 핸들 데이터 유형을 결정할 수 있습니다. 응용프로그램은 필요한 경우 일반 오브젝트 핸들을 함수에 필요한 데이터 유형으로 캐스트하여 오브젝트에서 조작을 수행하는 함수를 호출할 수 있습니다.