WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

InitialContext

應用程式會使用 InitialContext 物件, 以便從擷取自受管理物件儲存庫的物件定義來建立物件。

繼承階層:
xms::PropertyContext
   |
   +----xms::InitialContext

有關 XMS 所定義的 InitialContext 物件內容清單, 請參閱InitialContext 內容

相關概念
InitialContext 內容
XMS 起始環境定義的 URI 格式
受管理物件的擷取
相關工作
建立 InitialContext

建構子

建構子摘要:
建構子 說明
InitialContext 建立 InitialContext 物件。

InitialContext – 建立起始環境定義

介面:
InitialContext( const String & uri); 
InitialContext & create( const String & uri);

建立 InitialContext 物件。

註: InitialContext 物件的建立和連接內含受管理物件的儲存庫為兩項各自獨立的作業。如此一來, 可在連線之前即將內容設定在 InitialContext 物件中。如需進一步的詳細資料,請參閱InitialContext 內容
參數:
uri(輸入)
這個 String 物件封裝了一個 URI, 以識別內含受管理物件之儲存庫名稱和位置。URI 的精確語法取決於環境定義類型而定。如需進一步資訊, 請參閱XMS 起始環境定義的 URI 格式
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

方法

方法摘要:
方法 說明
~InitialContext 刪除 InitialContext 物件。這會釋出 InitialContext 物件的所有相關聯資源。
getHandle 取得 C 應用程式在存取 InitialContext 物件時所要使用的控點。
isNull 判斷 InitialContext 物件是否為一個空值物件。
lookup 從擷取自受管理物件儲存庫中的物件定義來建立物件。

~InitialContext – 刪除起始環境定義

介面:
InitialContext:: ~InitialContext();

刪除 InitialContext 物件。這會釋出 InitialContext 物件的所有相關聯資源。

如果應用程式試著刪除已刪除的 InitialContext 物件, 則會忽略該呼叫。

參數:
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 取得控點

介面:
xmsHInitialContext getHandle() const;

取得 C 應用程式在存取 InitialContext 物件時所要使用的控點。

參數:
傳回:
InitialContext 物件的控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

isNull – 檢查是否為空值

介面:
xmsBOOL isNull() const;

判斷 InitialContext 物件是否為一個空值物件。

參數:
傳回:
  • 如果 InitialContext 物件為空值物件,則為 xmsTRUE
  • 如果 InitialContext 物件不是空值物件,則為 xmsFALSE
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

lookup – 查閱起始環境定義中的物件

介面:
PropertyContext * lookup(const String & objectName) const;

從擷取自受管理物件儲存庫中的物件定義來建立物件。

參數:
objectName(輸入)
封裝受管理物件名稱的 String 物件。此名稱可以是簡式或複式的名稱。如需進一步的詳細資料,請參閱受管理物件的擷取
傳回:
所建物件的指標。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

繼承的方法


Reference topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)