WSWaitForNewLinkFromLinkServer （C 関数）

WSLINK WSWaitForNewLinkFromLinkServer(WSLinkServer s, int *err)

リンクサーバ s に新しい接続があるまで待つ．

詳細

  • WSWaitForNewLinkFromLinkServer()は，クライアントがリンクサーバオブジェクトに接続するのを同期的に待つ．
  • WSWaitForNewLinkFromLinkServer()は，新しいリンクオブジェクトへの接続を表すWSLINKオブジェクトを返す．
  • プログラムは，他のリンク操作を行う前に，WSLINKオブジェクトについてWSActivate()を呼び出さなければならない．
  • WSWaitForNewLinkFromLinkServer()でエラーが起った場合には，err 内のエラーの値が返され，(WSLINK)0が返される． WSWaitForNewLInkFromLinkServer()が成功した場合には，err にはゼロが含まれる．
  • エラーの条件を示す非零の値は，wstp.h内のWSEのエラーコードに対応し，WSError()が返すものと同じである．

例題

例  (1)

#include "wstp.h"

void operateLinkServerOnPort(WSENV env, unsigned short port)
{
    int error;
    WSLinkServer linkServer;
    WSLINK theLink;


    linkServer = WSNewLinkServerWithPort(env, port,
        NULL /* No context object for this example */, &error);
    if(error != WSEOK)
    { /* Handle error */ }

    theLink = WSWaitForNewLinkFromLinkserver(linkServer, &error);
    if(theLink == (WSLINK)0 || error != WSEOK)
    { /* Handle error */ }

    ...

    WSCLose(theLink);

    WSShutdownLinkServer(linkServer);
}