WSUCS2ErrorMessage （C 関数）

const unsigned short * WSUCS2ErrorMessage(WSLINK l, int *n)

l で指定されたWSTP接続上で最後に起ったエラーを説明する，長さ n のUCS2のコード形式でコード化された文字列を返す．

詳細

  • WSUCS2ErrorMessage()は，WSReleaseUCS2ErrorMessage()を呼び出すことによって解放しなければならないメモリを割り当てる．
  • WSUCS2ErrorMessage()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* A function for reading the error message from a link */

void f(WSLINK l)
{
    const unsigned short *message;
    int length;

    message = WSUCS2ErrorMessage(l, &length);
    if(message == (const unsigned short *)0 || length == 0)
    { /* Unable to get the error message from the link */ }

    /* ... */

    WSReleaseUCS2ErrorMessage(l, message, length);
}