WSUTF16ErrorMessage （C 函数）

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

返回一个由 UTF-16 字符编码的长度为 n 的字符字符串，其代表的消息描述发生在由 l 指定的 WSTP 连接上的最后一个错误.

更多信息

  • WSUTF16ErrorMessage() 为必须释放的消息字符串而分配内存. 使用 WSReleaseUTF16ErrorMessage() 来释放由 WSUTF16ErrorMessage() 分配的内存. 若 WSUTF16ErrorMessage() 返回 NULL，则不要用 NULL 值调用 WSReleaseUTF16ErrorMessage().
  • 程序不应该修改错误消息字符串的内容.
  • WSUTF16ErrorMessage() 会返回一个以适合平台的字节顺序标记（byte order mark）开始的字符串.
  • 该字符串的长度 n 包括这个字节顺序标记.
  • WSTP 的标头文件 wstp.h 已对 WSUTF16ErrorMessage() 作出声明.

范例

基本范例  (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);

    /* We check for length <= 1 below because the string
    should contain a byte order mark */
    if(message == (const unsigned short *)0 || length <= 1)
    { /* Unable to read the error message */ }

    /* ... */

    WSReleaseUTF16ErrorMessage(l, message, length);
}