WSReleaseEnvIDString （C 函数）

void WSReleaseEnvIDString(WSLINK link,const char *s)

释放由 WSGetLinkedEnvIDString() 分配的存储识别字符串 s 的内存.

更多信息

  • 在设置基于数据包的通讯之前识别双方的 WSTP 连接有时是很有用的. 使用 WSSetEnvIDString() ，开发人员可以为程序给出一个识别符，它会在每次与其他程序建立链接时进行交换. WSGetLinkedEnvIDString() 检索另一边链接的名称.
  • WSTP 的标头文件 wstp.h 已对 WSReleaseEnvIDString() 作出声明.

范例

基本范例  (1)

#include <string.h>
#include "wstp.h"

/* read the other side of the link's id string and check that it is "My Remote Program" */

int f(WSLINK lp)
{
    int isCorrectProg;
    const char *envid;

    if(! WSGetLinkedEnvIDString(lp, &envid))
        { /* unable to get remote side id from lp */ }

    isCorrectProg = strcmp(envid, "My Remote Program") == 0;

    WSReleaseEnvIDString(lp, envid, length);

    return isCorrectProg;
}