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 |
Property | xmsHProperty |
QueueBrowser | xmsHQueueBrowser |
Requestor | xmsHRequestor |
Session | xmsHSess |
某些函數會傳回通用的物件控點,這些控點和它們所建立之物件的類型無關。通用物件控點的資料類型為 xmsHObj。
如果應用程式從這些函數之一收到通用的物件控點, 應用程式可在 PropertyContext 類別中呼叫 xmsGetHandleTypeId() 函數, 以判斷物件類型的相關物件控點資料類型。之後,應用程式可視需要將通用的物件控點強制轉型為函數所需的資料類型, 藉以呼叫任何函數來對物件執行作業。