cciGetSourceTerminalName

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

構文

CciSize cciGetSourceTerminalName (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 sourceTerminalName[initialStringBufferLength];
   cciGetSourceTerminalName(&rc,
                            connection,
                            sourceTerminalName,
                            initialStringBufferLength);
}
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
as36020_