WSReleaseLinkProtocolNames (C 関数)

void WSReleaseLinkProtocolNames( WSENV env , char ** n , int l )

WSGetAvailableLinkProtocolNames()によって割り当てられたメモリを解放して,リンクプロトコル名を n に,リストの長さを l に保存する.

詳細

  • 名前リスト n は,WSGetAvailableLinkProtocolNames()への呼出しから得られたものでなければならない.
  • WSReleaseLinkProtocolNames()は,WSTPヘッダファイルwstp.hの中で宣言される.

例題

  (1)

#include "wstp.h"

/* A function for retrieving the available link protocols */

void f(WSENV env)
{
    const char **protocols;
    int length;
    int apiResult;

    apiResult = WSGetAvailableLinkProtocolNames(env, &protocols, &length);
    if(apiResult != 0)
    { /* Unable to get list of protocols from environment */ }

    /* ... */

    WSReleaseLinkProtocolNames(env, protocols, length);
}