3.3. ConnectionFactoryインタフェース

ConnectionFactoryインタフェースは、説明。

ConnectionFactoryインタフェースには次の関数があります。

JmsConnectionFactoryCreateConnection Connectionオブジェクトを生成します
JmsConnectionFactoryDestroy ConnectionFactoryオブジェクトを破棄します

   
3.3.1. JmsConnectionFactoryCreateConnection

名称 JmsConnectionFactoryCreateConnection - Connectionオブジェクトを生成します
形式 WOJMSStatus JmsConnectionFactoryCreateConnection( JmsConnectionFactory *factory, JmsConnection *connection, char *userName, char *password );
説明 factoryで指定したConnectionFactoryオブジェクトのcreateConnectionメソッドを、userNamepassword引数を指定して呼び出し、Connectionオブジェクトを生成します。生成したConnectionオブジェクトは、connectionで指定したJmsConnection構造体に設定して返却します。
引数 I/O パラメータ 説明
I factory createConnectionメソッドを呼び出すConnectionFactoryオブジェクトを指すJmsConnectionFactory構造体へのポインタを指定します。
O connection 生成したConnectionオブジェクトを受け取るためのJmsConnection構造体を指すポインタを指定します。
I userName 呼び出し側のユーザ名を指定します。createConnectionメソッド呼び出し時にJMSサーバ認証をおこなう場合に、設定されたユーザIDをNULL終端文字列で指定します。NULLを指定した場合は、ユーザ情報を指定しないcreateConnection,メソッドを呼び出します。
I password 呼び出し側のパスワードを指定します。createConnectionメソッド呼び出し時にJMSサーバ認証をおこなう場合に、設定されたユーザ名のパスワードをNULL終端文字列で指定します。NULLを指定した場合は、ユーザ情報を指定しないcreateConnectionメソッドを呼び出します
戻り値 WOJMS_NO_ERROR 0 正常に終了しました。
WOJMS_CAUGHT_EXCEPTION 1 関数実行中にスレッド内でExceptionがthrowされました。
WOJMS_INSUFFICIENT_MEMORY_ERROR -1 メモリ不足のため、バッファの確保に失敗しました。
WOJMS_INVALID_ARGUMENT_ERROR -2 指定された引数が不正です。
WOJMS_JVM_ERROR -4 JavaVMが無効です。
WOJMS_OBJECT_NOT_ACTIVE_ERROR -7 ConnectionFactoryオブジェクトが無効です。
関連項目 javax.jms.ConnectionFactory.createConnection(java.lang.String, java.lang.String)
   
3.3.2. JmsConnectionFactoryDestroy

名称 JmsConnectionFactoryDestroy - ConnectionFactoryオブジェクトを破棄します
形式 WOJMSStatus JmsConnectionFactoryDestroy( JmsConnectionFactory *factory );
説明 factoryで指定されたJmsConnectionFactory構造体に指定されているConnectionFactoryオブジェクトを破棄します。
引数 I/O パラメータ 説明
I factory ConnectionFactoryオブジェクトを指すJmsConnectionFactory構造体へのポインタを指定します。
戻り値 WOJMS_NO_ERROR 0 正常に終了しました。
WOJMS_CAUGHT_EXCEPTION 1 関数実行中にスレッド内でExceptionがthrowされました。
WOJMS_INVALID_ARGUMENT_ERROR -2 指定された引数が不正です。
WOJMS_JVM_ERROR -4 JavaVMが無効です。
関連項目 -