WSDuplicateLink （C 関数）

WSLINK WSDuplicateLink(WSLINK parent,const char *name,int *err)

parent のコピーを返し，新しいリンクオブジェクトの名前をname に設定する．

詳細

  • 新しく作成されたリンクは， parent リンクの受信データと送信データの流れの正確なコピーを持つ．
  • WSDuplicateLink()はユーザのデータブロックをコピーしない．
  • WSDuplicateLink()は完了が成功した場合には，新しいリンクオブジェクトを返し，err をWSEOKに設定する．
  • エラーがあると，WSDuplicateLink()は(WSLINK)0を返し，err を適切な値に設定する．
  • WSDuplicateLink()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* make a copy of a link */

WSLINK f(WSLINK lp)
{
    WSLINK newlink;
    int error;

    newlink = WSDuplicateLink(lp, (const char *)"Duplicate 1", &error);
    if(newlink == (WSLINK)0 || error != WSEOK)
        { /* unable to create a copy of the link */ }

    return newlink;
}