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

InitialContext

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

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

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

関数

関数の要約:
関数 説明
xmsInitialContextCreate InitialContext オブジェクトを作成します。
xmsInitialContextDispose InitialContext オブジェクトを削除します。
xmsInitialContextLookup 管理対象オブジェクトのリポジトリーから取得したオブジェクト定義によって、オブジェクトを作成します。

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

インターフェース:
xmsRC xmsInitialContextCreate(xmsCHAR *URL,
xmsHInitialContect *initalContext,
xmsHErrorBlock errorBlock);

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

パラメーター:
URL (入力)
管理対象オブジェクトを含むリポジトリーの名前およびロケーションを識別する URL (Uniform Resource Locator)。URL はヌル終了ストリング形式です。
initialContext (出力)
InitialContext オブジェクトのハンドル。
errorBlock (入力)
エラー・ブロックのハンドルまたは NULL ハンドル。
例外:
  • XMS_X_GENERAL_EXCEPTION

xmsInitialContextDispose – 初期コンテキストの削除

インターフェース:
xmsRC xmsInitialContextDispose(xmsHInitialContext *initialContext,
xmsHErrorBlock errorBlock);

InitialContext オブジェクトを削除します。

アプリケーションが、既に削除されている InitialContext オブジェクトを削除しようとした場合、呼び出しは無視されます。

パラメーター:
initialContext (入出力)
入力では、InitialContext オブジェクトのハンドル。出力で、関数は NULL ハンドルを戻します。
errorBlock (入力)
エラー・ブロックのハンドルまたは NULL ハンドル。
例外:
  • 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 (入力)
エラー・ブロックのハンドルまたは NULL ハンドル。
例外:
  • 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)