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

InitialContext

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

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

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

函數

函數摘要:
函數 說明
xmsInitialContextCreate 建立 InitialContext 物件。
xmsInitialContextDispose 刪除 InitialContext 物件。
xmsInitialContextLookup 從擷取自受管理物件儲存庫中的物件定義來建立物件。

xmsInitialContextCreate – 建立起始環境定義

介面:
xmsRC xmsInitialContextCreate(xmsCHAR *URL,
                              xmsHInitialContect *initalContext,
                              xmsHErrorBlock errorBlock);

建立 InitialContext 物件。

參數:
URL(輸入)
識別內含受管理物件之儲存庫的名稱和位置的統一資源定址器 (URL)。URL 採用空值終止字串格式。
initialContext(輸出)
InitialContext 物件的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsInitialContextDispose – 刪除起始環境定義

介面:
xmsRC xmsInitialContextDispose(xmsHInitialContext *initialContext,
                               xmsHErrorBlock errorBlock);

刪除 InitialContext 物件。

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

參數:
initialContext(輸入/輸出)
在輸入方面,為 InitialContext 物件的控點。在輸出方面,函數會傳回空值控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

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

介面:
xmsRC xmsInitialContextLookup(xmsHInitialContext initialContext,
                              xmsCHAR *objectName,
                              xmsHObj *returnedObject,
                              xmsHANDLE_TYPE *handleType,
                              xmsHErrorBlock errorBlock);

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

參數:
initialContext(輸入)
InitialContext 物件的控點。
objectName(輸入)
受管理物件的名稱,採用空值終止字串格式。
returnedObject(輸出)
所建物件的控點。
handleType(輸出)
所建物件的控點類型,其值為下列之一:
  • XMS_HANDLE_TYPE_CONNFACT
  • XMS_HANDLE_TYPE_DEST
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

Reference topic

使用條款 | 評比此網頁

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