主题
服务端发送数据 - TcpServerSend
函数简介
向指定连接发送数据。
接口名称
TcpServerSendDLL调用
c
int32_t TcpServerSend(int64_t instance, int64_t server_handle, int64_t conn_id, int64_t data, int32_t data_len);参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | 长整数型 | OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。 |
| server_handle | 长整数型 | 服务端句柄。 |
| conn_id | 长整数型 | 连接ID(从回调中获得)。 |
| data | 长整数型 | 数据指针。 |
| data_len | 整数型 | 数据长度。 |
示例
SDK 调用
cpp
#include "OLAPlugServer.h"
OLAPlugServer ola;
long server = ola.TcpServerCreate("0.0.0.0", 9000, nullptr, 0, 0);
long connId = 1;
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen);csharp
using OLAPlug;
var ola = new OLAPlugServer();
long server = ola.TcpServerCreate("0.0.0.0", 9000, nullptr, 0, 0);
long connId = 1;
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen);python
from OLAPlugServer import OLAPlugServer
ola = OLAPlugServer()
server = ola.TcpServerCreate("0.0.0.0", 9000, nullptr, 0, 0)
connId = 1
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen)java
import com.olaplug.OLAPlugServer;
OLAPlugServer ola = new OLAPlugServer();
long server = ola.TcpServerCreate("0.0.0.0", 9000, nullptr, 0, 0);
long connId = 1;
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen);cpp
var ola = com("OlaPlug.OlaSoft")
var server = ola.TcpServerCreate("0.0.0.0", 9000, nullptr, 0, 0)
var connId = 1
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen);vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
server = ola.TcpServerCreate("0.0.0.0", 9000, nullptr, 0, 0)
connId = 1
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen);text
.局部变量 ola, OLAPlug
ola.创建 ()
server = ola.TcpServerCreate(“0.0.0.0“, 9000, nullptr, 0, 0)
connId = 1
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen)aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var server = ola.TcpServerCreate("0.0.0.0", 9000, nullptr, 0, 0);
var connId = 1;
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen);text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 server = ola.TcpServerCreate("0.0.0.0", 9000, nullptr, 0, 0)
长整数 connId = 1
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen);cpp
#include "OLAPlugServer.h"
OLAPlugServer ola;
long server = ola.TcpServerCreate("0.0.0.0", 9000, nullptr, 0, 0);
long connId = 1;
ola.TcpServerSend(server, connId, (long)dataPtr, dataLen);原生 DLL 调用
cpp
long instance = CreateCOLAPlugInterFace();
long server = TcpServerCreate(instance, "0.0.0.0", 9000, nullptr, 0, 0);
TcpServerSend(instance, server, connId, (long)dataPtr, dataLen);csharp
long instance = CreateCOLAPlugInterFace();
long server = TcpServerCreate(instance, "0.0.0.0", 9000, nullptr, 0, 0);
TcpServerSend(instance, server, connId, (long)dataPtr, dataLen);python
from ctypes import CDLL, c_int, c_int64, create_string_buffer
ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
server = TcpServerCreate(instance, "0.0.0.0", 9000, nullptr, 0, 0)
TcpServerSend(instance, server, connId, (long)dataPtr, dataLen)返回值
| 返回值 | 说明 |
|---|---|
| (返回值) | 整数型,1 成功(加入发送队列),0 失败。 |
注意事项
| 项目 | 说明 |
|---|---|
| 这是异步操作 | 这是异步操作,数据会被加入发送队列。 |
| 发送完成后会触发回调(event_type=3) | 发送完成后会触发回调(event_type=3)。 |
| 如果启用了分包协议 | 如果启用了分包协议,会自动添加4字节长度前缀。 |
| 如果连接不存在 | 如果连接不存在,发送会失败。 |
| 数据会被复制 | 数据会被复制,调用后可以立即释放原始数据。 |
