WSLowLevelDeviceName （C 函数）

int WSLowLevelDeviceName( WSLINK l , const char ** name )

获取链接名称的低级协议（low-level protocol），该名称为由 l 指定的 WSTP 连接的链接名称，结果储存在 name 中.

更多信息

  • WSLowLevelDeviceName() 必须通过调用 WSReleaseLowLevelDeviceName() 来释放的名称而分配内存. 若 WSLowLevelDeviceName() 返回一个错误，则不要调用有 name 内容的 WSReleaseLowLevelDeviceName().
  • 若成功，则 WSLowLevelDeviceName() 返回1；若失败，则返回0.
  • WSTP 的标头文件 wstp.h 已对 WSLowLevelDeviceName() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

int main(int argc, char **argv)
{
    WSENV env;
    WSLINK link;
    int error;
    const char *name;
    int apiResult;

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

    link = WSOpenArgcArgv(env, argc, argv, &error);
    if(link == (WSLINK)0 || error != WSEOK)
    { /* Unable to create the link object */ }

    WSActivate(link);

    apiResult = WSLowLevelDeviceName(link, &name);
    if(apiResult == 0)
    { /* Failed to retrieve low level name */ }

    /* ... */

    WSReleaseLowLevelDeviceName(link, name);        

    /* .... */

    WSClose(link);
    WSDeinitialize(env);
    return 0;
}