ACIPing()

ACIPing()

作用：

往返调用服务器以确认连接和服务器处于活动状态。

语法：

sword ACIPing ( ACISvcCtx     *svchp,
                ACIError      *errhp,
                ub4            mode );

参数：

• svchp（IN）

服务上下文的句柄。 服务上下文句柄必须被初始化，并具有与其关联的服务器上下文句柄。

• errhp（IN）

当发生错误时，可以将其传递给 ACIErrorGet 以获得诊断信息的错误句柄。

• mode（IN）

通话方式。 使用ACI_DEFAULT。

说明：

ACIPing 对服务器进行虚拟的往返调用；即，将伪包发送到服务器以进行响应。往返完成后， ACIPing 返回。对此调用本身不执行任何服务器操作。

可以使用 ACIPing 对服务器进行轻量级调用。呼叫成功返回表明连接和服务器处于活动状态。如果调用阻塞，则其他线程可能正在使用该连接。如果失败，则连接或服务器可能存在问题，并且可以从错误句柄中检索错误。