WSPutMessage （C 関数）

int WSPutMessage(WSLINK link,int msg)

メッセージmsg をリンクオブジェクトlink に送信する．

詳細

  • WSTPメッセージは，通常のデータの転送に関連していない帯域外メッセージの送信・受信を行う．
  • WSPutMessage()はエラーがあると0を返し, 関数が成功すると0以外の値を返す.
  • WSError()を使うと，WSPutMessage()が不成功の場合にエラーコードを引き出すことができる.
  • WSPutMessage()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* send an abort message to a link */

void f(WSLINK lp)
{
    if(! WSPutMessage(lp, WSAbortMessage))
        { /* unable to send message to lp */ }
}