Connection オブジェクトは、アプリケーションによるブローカーへのアクティブな接続を表します。
Connection オブジェクトの XMS 定義プロパティーのリストについては、Connection のプロパティーを参照してください。
関数 | 説明 |
---|---|
xmsConnClose | 接続を閉じます。 |
xmsConnCreateSession | セッションを作成します。 |
xmsConnGetClientID | 接続のクライアント ID を取得します。 |
xmsConnGetExceptionListener | 接続に登録されている例外リスナー関数およびコンテキスト・データへのポインターを取得します。 |
xmsConnGetMetaData | 接続のメタデータを取得します。 |
xmsConnSetClientID | 接続のクライアント ID を設定します。 |
xmsConnSetExceptionListener | 接続に、例外リスナー関数およびコンテキスト・データを登録します。 |
xmsConnStart | 接続の着信メッセージの配信を開始または再開します。 |
xmsConnStop | 接続の着信メッセージの配信を停止します。 |
xmsRC xmsConnCreateSession(xmsHConn connection, xmsBOOL transacted, xmsINT acknowledgeMode, xmsHSess *session, xmsHErrorBlock errorBlock);
ブローカーへのリアルタイム接続の場合、値は xmsFALSE である必要があります。
セッションが処理済みの場合、このパラメーターは無視されます。肯定応答モードについて詳しくは、セッションでのメッセージの受信の確認を参照してください。
xmsRC xmsConnGetClientID(xmsHConn connection, xmsCHAR *clientID, xmsINT length, xmsINT *actualLength, xmsHErrorBlock errorBlock);
ブローカーへのリアルタイム接続の場合、この関数は無効です。
この関数の使用方法について詳しくは、値によりストリングを戻す C 関数を参照してください。
xmsRC xmsConnGetExceptionListener(xmsHConn connection, fpXMS_EXCEPTION_CALLBACK *lsr, xmsCONTEXT *context, xmsHErrorBlock errorBlock);
接続に登録されている例外リスナー関数およびコンテキスト・データへのポインターを取得します。
例外リスナー関数の使用について詳しくは、C での例外リスナー関数の使用法を参照してください。
xmsRC xmsConnSetClientID(xmsHConn connection, xmsCHAR *clientID, xmsINT length, xmsHErrorBlock errorBlock)
接続のクライアント ID を設定します。クライアント ID は、パブリッシュ/サブスクライブ・ドメイン内の永続サブスクリプションをサポートするためだけに使用され、Point-to-Point ドメインでは無視されます。
アプリケーションがこの関数を呼び出して接続のクライアント ID を設定する場合、アプリケーションは、接続の作成の直後に、接続で他の操作を実行する前にこの設定を行う必要があります。アプリケーションが、この時点よりも後に、この関数の呼び出しを試行すると、関数は例外 XMS_X_ILLEGAL_STATE_EXCEPTION を戻します。
ブローカーへのリアルタイム接続の場合、このメソッドは無効です。
xmsRC xmsConnSetExceptionListener(xmsHConn connection, fpXMS_EXCEPTION_CALLBACK lsr, xmsCONTEXT context, xmsHErrorBlock errorBlock);
接続に、例外リスナー関数およびコンテキスト・データを登録します。
例外リスナー関数の使用について詳しくは、C での例外リスナー関数の使用法を参照してください。