WSLinkName （C 函数）

const char * WSLinkName(WSLINK link)

返回用于创建链接的名称字符串.

更多信息

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

范例

基本范例  (3)

用 LinkLaunch 打开的链接将已执行的完整命令行作为链接名称：

完整的链接名称被存储为 LinkObject 的第一个元素：

用 LinkCreate 打开的链接具有依赖于协议的名称，其中含有连接信息：

默认的 "SharedMemory" 协议将使用共享内存对象的名称：

声明一个 const char * 变量并获取链接名称：

#include "wstp.h"

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

void f(WSLINK lp)
{
    const char *name;

    name = WSLinkName(lp);
    if(name == (const char *)0)
    { /* Unable to get the link name */ }

    /* ... */

    WSReleaseLinkName(lp, name);
}