変更の始まり

cciGetTargetTerminalName

この関数は、指定された接続のターゲット・ノードの入力ターミナルの名前を戻します。

構文

CciSize cciGetTargetTerminalName (int* returnCode,
CciConnection* connection,
CciChar* value,
CciSize length);

パラメーター

returnCode (出力)
関数からの戻りコードを受け取ります (出力)。
  • CCI_BUFFER_TOO_SMALL

    提供されたバッファーの容量が小さかったため、ノード名の値を保持できませんでした。

connection (入力)
これは、2 つのノード間の接続へのハンドルです。
value (出力)
ターミナル名の値を保持するために呼び出し側によって割り振られたバッファーのアドレス。
length
呼び出し側によって割り振られたバッファーの長さ (CciChar 単位)。

戻り値

  • 正常に実行されると、提供されるバッファーにターミナル名がコピーされ、コピーされた CciChar 文字の数が戻されます。
  • バッファーの大きさが不十分でターミナル名を含めることができない場合、returnCode は CCI_BUFFER_TOO_SMALL に設定され、必要な CciChar の数が戻されます。

void myPropagatedMessageCallback(
CciDataContext* userContext,
CciMessage* message,
CciMessage* localEnvironment,
CciMessage* exceptionList,
CciMessage* environment,
CciConnection* connection){
int rc = CCI_SUCCESS;
CciChar targetTerminalName[initialStringBufferLength];
cciGetTargetTerminalName(&rc,
connection,
targetTerminalName,
initialStringBufferLength);
/*you should now check the rc for unexpected values*/
/*if rc is CCI_BUFFER_TOO_SMALL then you should resize and retry*/
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 Last updated: 5 01, 2006
as36030_


変更の終わり