Prg_Ipc_Port_Create_Listen()
摘要
创建一个具有给定 IP 端口号的 PRG IPC 端口并监听连接请求。
语法
Prg_Ipc_Port_Create_Listen (port_number, handler, ph_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
port_number |
int |
所创建端口将进行监听的 IP 端口号 |
handler |
PrgT_Ipc_Packet_Handler | 当任何数据进入所创建端口时被调用的处理函数 |
返回类型
PrgT_Compcode
成功时返回 PrgC_Compcode_Success,失败时返回 PrgC_Compcode_Failure
头文件
prg_ipc.h
详情
在给定的 IP 端口号(例如 4537)上创建 PRG IPC 端口并开始监听对该端口的连接请求,然后通过设置 ph_ptr 返回该端口的句柄。此函数还会为该端口注册传入数据处理函数和端口状态通知。
如果 port_number 为 PRGC_IPC_LISTEN_PORT_ANY,则所创建的端口将在一个由调用方程序确定的 IP 端口号上监听(以避免与其他正在运行的程序发生 IP 端口冲突)。实际的 IP 端口号可以通过对返回的端口句柄调用 Prg_Ipc_Port_Listen_Port_Number_Get() 获得。
handler 的函数原型见 PrgT_Ipc_Packet_Handler。