WSReleaseEnvIDString （C 関数）

void WSReleaseEnvIDString(WSLINK link,const char *s)

識別文字列 s を保持するために，WSGetLinkedEnvIDString()で割り当てられたメモリを解放する．

詳細

  • パケットに基づく交信を設定する前に，WSTP接続の側を特定したほうがよいこともある．WSSetEnvIDString()を使うことによって，別のプログラムとのリンクを設置する度に，開発者は交換されるプログラムに識別文字列を与えることができる．WSGetLinkedEnvIDString()はリンクの反対側の名前を取り出す．
  • WSReleaseEnvIDString()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (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;
}