WSWaitForLinkActivity （C 関数）

int WSWaitForLinkActivity(WSLINK l)

l で指定されたWSTP接続で読み込むデータがあるまで返さない．

詳細

  • ユーザインターフェースやアプリケーションのメインスレッドを妨げないように，データを待たなければならないバックグラウンドスレッドでWSWaitForLinkActivity()を使う．
  • ロギングのために有効にされたリンク上でのリンクアクティビティを待つ必要がある場合に，WSWaitForLinkActivity()（あるいは関連する関数であるWSWaitForLinkActivityWithCallback()）を使う．
  • WSWaitForLinkActivity()は，エラーが起った場合にはWSWAITERRORを，そして関数が成功した場合にはWSWAITSUCCESSを返す．
  • WSWaitForLinkActivity()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* A function for waiting on link activity */

void f(WSLINK l)
{
    switch(WSWaitForLinkActivity(l))
    {
        case WSWAITERROR:
            /* Handle the error */
            break;
        case WSWAITSUCCESS:
        default:
            /* Do something else */
    }
}