WSError （C 関数）
int WSError(WSLINK link)
link 上で最も最近に発生したエラーを明らかにする値を返す．WSError()は，前回のWSClearError()への呼出し以来エラーが起っていない場合には，WSEOKを返す．
詳細
- WSErrorMessage()を呼び出すと，テキスト形式のエラーの説明を得ることができる．
- WSError()は以下の値を返すことができる:
-
WSEOK すべてオーケーです WSEDEAD リンクがなくなりました WSEGBAD 相反するデータを読み取りました WSEGSEQ WSGet()関数が誤った順序で呼び出されました WSEPBTK WSPutNext()が悪いトークンを送信しました WSEPSEQ WSPut()関数が誤った順序で呼び出されました WSEPBIG WSPutData()が過度のデータを受け取りました WSEOVFL マシン番号のオーバーフロー WSEMEM メモリ切れ WSEACCEPT ソケットの接続を受け入れられません WSECONNECT 据え置き中の接続がまだつながっていません WSEPUTENDPACKET WSEndPacket()の予期しない呼出しと失われた呼出し WSENEXTPACKET 現行パケットに読み取られていないデータがあるにもかかわらずWSNextPacket()が呼び出されました WSEUNKNOWNPACKET WSNextPacket()が不明のパケットヘッドで読み取られました WSEGETENDPACKET パケットの予期しない終了 WSEABORT リンクが影響を受ける前にプットあるいはゲットは放棄されました WSECLOSED リンクの向こう側が接続を閉じました (未受け取りのデータはまだ受け取ることができるかもしれません) WSEINIT WSTP環境は初期化されませんでした WSEARGV 不完全な引数のためリンクを開けません WSEPROTOCOL プロトコルが使えません WSEMODE モードが使えません WSELAUNCH 実行が支持されませんでした WSELAUNCHAGAIN 同じファイルからもう一度プログラムを実行することはできません WSELAUNCHSPACE プログラムを実行するのに容量が足りません WSENOPARENT 接続できる親リンクがありません WSENAMETAKEN そのリンク名はすでに使われています WSENOLISTEN そのリンク名は聞いていないことが分かりました WSEBADNAME そのリンク名はなくなったか，あるいは正しい形式ではありません WSEBADHOST その場所は接続できないか，あるいは正しい形式になっていません WSELAUNCHFAILED リソースかライブラリが見つからないのでプログラムを実行することができませんでした WSELAUNCHNAME プログラムが見付からないので実行することができませんでした WSEPSCONVERT 与えられた文字コード規格からリンクコード規格に変換することができません WSEGSCONVERT リンクコード規格から要請されたコード規格に変換することができません WSEPDATABAD 文字データは誤ったコード規格で与えられています WSENOTEXE 指定されたファイルはWSTPで実行可能なものではありません WSESYNCOBJECTMAKE WSTPの同期オブジェクトを作成することができません WSEBACKOUT 降伏関数がWSTP操作を終了しました WSEBADOPTSYM リンク上の記号値を認識することができません WSEBADOPTSTR リンク上の文字列の値を認識することができません WSENEEDBIGGERBUFFER 関数の呼出しにより大きなバッファ引数が必要です - WSError()は，WSTPヘッダファイルwstp.hの中で宣言される．
例題
例 (1)
#include "wstp.h"
/* send the integer 10 to a link */
void f(WSLINK lp)
{
if(! WSPutInteger(lp, 10))
{
/* check the possible errors */
switch(WSError(lp))
{
case WSEDEAD:
/* the link died unexpectedly */
break;
case WSECLOSED:
/* the other side closed the link */
break;
case WSEOK:
/* no error occurred */
break;
default:
/* ... */
}
}
}