WSOpenArgcArgv (C 函数)

WSLINK WSOpenArgcArgv(WSENV env,int argc,char** argv,int* errno)

打开一个 WSTP 连接,从命令行自变量中接受参数.

更多信息

  • WSInitialize() 必须在 WSOpenArgcArgv() 之前调用.
  • WSOpenArgcArgv() 处理命令行参数并使用它们控制链接的创建.
  • WSOpenArgcArgv() 识别以下命令行自变量:
  • "-linkconnect"连接至一个已存在的链接(LinkConnect
    "-linkcreate"创建一个链接(LinkCreate
    "-linklaunch"启动一个子处理(LinkLaunch
    "-linkname","name"打开链接使用的名称
    "-linkprotocol","protocol"使用的链接协议(TCPIP管道、共享内存、内进程等)
  • WSOpenArgcArgv() 对于自变量名称的大小写不敏感.
  • WSOpenArgcArgv() 忽略不被识别的自变量名称.
  • WSOpenArgcArgv() 被由 wsprepwscc 创建的 WSMain() 函数自动调用.
  • 在某些计算机系统,对于 设0或对 设一个零指针将导致互动式要求自变量,一般通过对话框.
  • WSTP 的标头文件 wstp.h 已对 WSOpenArgcArgv() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* create a link using command-line parameters */

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

    env = WSInitialize((WSEnvironmentParameter)0);
    if(env == (WSENV)0)
        { /* unable to initialize the WSTP environment */ }

    /* let WSOpenArgcArgv process the command line */
    link = WSOpenArgcArgv(env, argc, argv, &error);
    if(link == (WSLINK)0 || error != WSEOK)
        { /* unable to create the link */ }

    /* ... */

    WSClose(link);
    WSDeinitialize(env);

    return 0;
}