DLLSysConnect

函数 DLLSysConnect 建立与 One 控制器的客户端会话，返回会话句柄。（支持同一进程内多客户端并发。）

所属：C/C++ API 函数索引

C/C++

ErrorCode DLLSysConnect(INT_PTR* phClientHandle);

C#

Controller Controller.Connect() — 连接至当前配置的控制器地址（默认 127.0.0.1:60049，地址由 Setup Manager 应用配置），建立会话并返回 Controller 实例。

参数

phClientHandle (INT_PTR*)

输出。接收新客户端会话句柄。后续所有 API 调用（除 DLLSetControllerAddress、DLLDiscoverControllers、DLLGetLastCommandDetail 外）均使用该句柄。多个客户端可并发连接至同一控制器，各自独立订阅事件。

返回值

返回 ErrorCode；NoError (0) 表示成功，正值为错误码，详见 SDK 发布头 ErrorCode.h。可能返回的错误码包括 NotConnected、NetworkSocketError 等。

说明

建立连接后应调用 DLLInitializeSystem 完成控制器初始化。客户端不再使用时必须调用 DLLSysDisconnect 释放资源。

示例

INT_PTR handle = 0;
if (DLLSysConnect(&handle) != NoError) return 1;
/* ... 使用 handle 调用其他 API ... */
DLLSysDisconnect(handle);

相关函数

• DLLSysDisconnect
• DLLInitializeSystem
• DLLSetControllerAddress