WSUCS2LinkName （C 函数）

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

从由 l 指定的 WSTP 连接返回一个长度为 n 、编码为 UCS2 字符串的链接名称.

更多信息

  • WSUCS2LinkName() 为链接名称分配必须释放的内存. 若要释放该内存，则可用函数返回的值来调用 WSReleaseUCS2LinkName(). 若 WSUCS2LinkName() 返回 NULL，则不要使用 NULL 值调用 WSReleaseUCS2LinkName().
  • 程序不应修改 WSUCS2LinkName() 返回的字符串的内容.
  • 可结合链接模式、链接协议和其它选项来创建 WSTP 链接. 链接名称为用来创建链接的链接模式和链接协议提供了必要信息.
  • WSTP 的标头文件 wstp.h 已对 WSUCS2LinkName() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* A function for reading a link's name */

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

    name = WSUCS2LinkName(l, &length);
    if(name == NULL || length == 0)
    { /* Unable to read link name */ }

    /* ... */

    WSReleaseUCS2LinkName(l, name, length);
}