WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 オペレーティング・システム: Linux, Windows

InitialContext

アプリケーションは、InitialContext オブジェクトを使用して、管理対象オブジェクトのリポジトリーから取得したオブジェクト定義によってオブジェクトを作成します。

継承の階層:
xms::PropertyContext
|
+----xms::InitialContext

InitialContext オブジェクトの XMS 定義プロパティーのリストについては、InitialContext のプロパティーを参照してください。

関連概念
InitialContext プロパティー
XMS 初期コンテキストの URI フォーマット
管理対象オブジェクトの検索
関連タスク
InitialContext の作成

コンストラクター

コンストラクターの要約:
コンストラクター 説明
InitialContext InitialContext オブジェクトを作成します。

InitialContext – 初期コンテキストの作成

インターフェース:
InitialContext( const String & uri);
InitialContext & create( const String & uri);

InitialContext オブジェクトを作成します。

注: InitialContext オブジェクトの作成は、管理対象オブジェクトを収容しているリポジトリーへの接続とは別個に行われます。 こうすると、接続する前に、InitialContext オブジェクトのプロパティーを設定できます。詳しくは、InitialContext プロパティーを参照してください。
パラメーター:
uri (入力)
管理対象オブジェクトを収容しているリポジトリーの名前と場所を示す URI をカプセル化している String オブジェクトです。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

ご利用条件 | フィードバック (英語のみ)

Timestamp icon最終更新: 8 Jun 2006
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています。(http://www.eclipse.org)