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

ConnectionFactory

アプリケーションは、接続ファクトリーを使用して接続を作成します。

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

関連概念
接続ファクトリーおよび接続
WebSphere サービス統合バスへの接続
関連タスク
管理対象オブジェクトの作成

関数

関数の要約:
関数 説明
xmsConnFactCreate デフォルトのプロパティーを使用して接続ファクトリーを作成します。
xmsConnFactCreateConnection デフォルトのユーザー ID を使用して接続を作成します。
xmsConnFactCreateConnectionForUser 指定されたユーザー ID を使用して接続を作成します。
xmsConnFactDispose 接続ファクトリーを削除します。

xmsConnFactCreate – Create Connection Factory

インターフェース:
xmsRC xmsConnFactCreate(xmsHConnFact *factory,
xmsHErrorBlock errorBlock);

デフォルトのプロパティーを使用して接続ファクトリーを作成します。

パラメーター:
factory (出力)
接続ファクトリーのハンドル。
errorBlock (入力)
エラー・ブロックのハンドルまたは NULL ハンドル。
例外:
  • XMS_X_GENERAL_EXCEPTION

xmsConnFactCreateConnection – 接続の作成 (デフォルト・ユーザー ID を使用)

インターフェース:
xmsRC xmsConnFactCreateConnection(xmsHConnFact factory,
xmsHConn *connection,
xmsHErrorBlock errorBlock);

デフォルトのユーザー ID を使用して接続を作成します。

接続ファクトリーのプロパティー XMSC_USERID および XMSC_PASSWORD は、設定されている場合、アプリケーションの認証に使用されます。これらのプロパティーが設定されていない場合、メッセージング・サーバーが認証なしの接続を許可しているのであれば、アプリケーションを認証せずに接続が作成されます。アプリケーションがバインディング・モードで WebSphere MQ キュー・マネージャーに接続する場合、このプロパティーは無視されます。

接続は停止済みモードで作成されます。 アプリケーションが xmsConnStart() を呼び出すまで、メッセージは配信されません。

パラメーター:
factory (入力)
接続ファクトリーのハンドル。
connection (出力)
接続のハンドル。
errorBlock (入力)
エラー・ブロックのハンドルまたは NULL ハンドル。
例外:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_SECURITY_EXCEPTION

xmsConnFactCreateConnectionForUser – 接続の作成 (指定されたユーザー ID を使用)

インターフェース:
xmsRC xmsConnFactCreateConnectionForUser(xmsHConnFact factory,
xmsCHAR *userID,
xmsCHAR *password,
xmsHConn *connection,
xmsHErrorBock errorBlock);

指定されたユーザー ID を使用して接続を作成します。

アプリケーションの認証に、指定したユーザー ID およびパスワードが使用されます。接続ファクトリーのプロパティー XMSC_USERID および XMSC_PASSWORD は、設定されている場合、無視されます。アプリケーションがバインディング・モードで WebSphere MQ キュー・マネージャーに接続する場合、ユーザー ID およびパスワードは無視されます。

接続は停止済みモードで作成されます。 アプリケーションが xmsConnStart() を呼び出すまで、メッセージは配信されません。

パラメーター:
factory (入力)
接続ファクトリーのハンドル。
userID (入力)
アプリケーションの認証に使用されるユーザー ID。ユーザー ID はヌル終了ストリング形式です。ユーザー ID が NULL の場合、接続ファクトリー・プロパティー XMSC_USERID が代わりに使用されます。
password (入力)
アプリケーションの認証に使用されるパスワード。パスワードはヌル終了ストリング形式です。パスワード が NULL の場合、接続ファクトリー・プロパティー XMSC_PASSWORD が代わりに使用されます。
connection (出力)
接続のハンドル。
errorBlock (入力)
エラー・ブロックのハンドルまたは NULL ハンドル。
例外:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_SECURITY_EXCEPTION

xmsConnFactDispose – 接続ファクトリーの削除

インターフェース:
xmsRC xmsConnFactDispose(xmsHConnFact *factory,
xmsHErrorBlock errorBlock);

接続ファクトリーを削除します。

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

パラメーター:
factory (入出力)
入力では、接続ファクトリーのハンドル。出力で、関数は NULL ハンドルを戻します。
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)