WSGetAvailableLinkProtocolNames （C 函数）

int WSGetAvailableLinkProtocolNames( WSENV env , char *** p , int * l )

从 WSTP 环境 env 获取含有安装链接协议名称的字符串列表，字符串保存在 p 中，名称列表长度保存在 l 中.

更多信息

  • WSTP 目前支持如下链接协议名称：SharedMemory、TCPIP、IntraProcess、Pipes、FileMap 和 TCP.
  • 并非所有链接协议都可应用于所有平台.
  • 平台协议
    LinuxSharedMemory, TCPIP, Intraprocess, Pipes, TCP
    WindowsSharedMemory, TCPIP, IntraProcess, FileMap, TCP
    OS XSharedMemory, TCPIP, IntraProcess, Pipes, TCP
  • WSGetAvailableLinkProtocolNames() 分配内存以储存必须调用 WSReleaseLinkProtocolNames()才能放出的协议名称列表. 如果 WSGetAvailableLinkProtocolNames() 返回错误，则不能调用 WSReleaseLinkProtocolNames() p 中的内容.
  • 若成功，WSGetAvailableLinkProtocolNames() 返回0；若失败，则返回非零值.
  • WSTP 的标头文件 wstp.h 已对 WSGetAvailableLinkProtocolNames() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

int main()
{
    WSENV env;
    char **protocolNames;
    int length;
    int apiResult;

    env = WSInitialize((WSEnvironmentParameter)0);
    if(env == (WSENV)0)
    { /* Unable to create WSTP environment */ }

    apiResult = WSGetAvailableLinkProtocolNames(env, &protocolNames, &length);
    if(apiResult != 0)
    { /* Unable to retrieve link protocol names */ }

    /* ... */

    WSReleaseLinkProtocolNames(env, protocolNames, length);

    WSDeinitialize(env);
}