文档介绍：行情客户端应用程序接口
10月19日
文献版本号
修正日期
备 注
-03-28
初次发布
-08-07
修改示例程序，，客户端必需在连接行情服务器时，订阅一种或多种行情发布主题。
运营模式
工作线程
交易员客户端应用程序至少由两个线程构成，一种是应用程序主线程，一种是交易员API工作线程。应用程序与交易系统的通讯是由API工作线程驱动的。
CFfexFtdcMduserApi提供的接口是线程安全的，可以有多种应用程序线程同步发出祈求。
CFfexFtdcMduserSpi提供的接口回调是由API工作线程驱动，如果重载的某个回调函数阻塞，则等于阻塞了API工作线程，API与交易系统的通讯会停止。因此，在CFfexFtdcTraderSpi派生类的回调函数中，一般应迅速返回，可以运用将数据放入缓冲区或通过Windows的消息机制来实现。
本地文献
交易员API在运营过程中，会将某些数据写入本地文献中。调用CreateFtdcMduserApi函数，可以传递一种参数，指明存贮本地文献的途径。该途径必须在运营前已创立好。本地文献的扩展名都是”.con”。
开发接口
行情客户端系统API提供了二个接口，分别为CFfexFtdcMduserApi和CFfexFtdcMduserSpi。
CFfexFtdcMduserSpi 接口
CFfexFtdcMduserSpi实现了事件告知接口。顾客必需派生CFfexFtdcMduserSpi接口，编写事件解决措施来解决感爱好的事件。
OnFrontConnected 措施
当客户端与行情发布服务器建立起通信连接时（尚未登录前），该措施被调用。
函数原型：
void OnFrontConnected()；
本措施在完毕初始化后调用，可以在其中完毕顾客登录任务。
OnFrontDisconnected 措施
当客户端与交易后台通信连接断开时，该措施被调用。当发生这个状况后，API会自动重新连接，客户端可不做解决。
函数原型：
void OnFrontDisconnected (int nReason)；
参数：
nReason：连接断开因素
0x1001 网络读失败
0x1002 网络写失败
0x 接受心跳超时
0x 发送心跳失败
0x 收到错误报文
OnHeartBeatWarning措施
心跳超时警告。当长时间未收到报文时，该措施被调用。
函数原型：
void OnHeartBeatWarning(int nTimeLapse)；
参数：
nTimeLapse：距离上次接受报文的时间
OnRspUserLogin措施
当客户端发出登录祈求之后，该措施会被调用，告知客户端登录与否成功。
函数原型：
void OnRspUserLogin(
CFfexFtdcRspUserLoginField *pRspUserLogin,
CFfexFtdcRspInfoField *pRspInfo,
int nRequestID,
bool bIsLast)；
参数：
pRspUserLogin：返回顾客登录信息的地址。
顾客登录信息构造：
struct CFfexFtdcRspUserLoginField
{
///交易日
TFfexFtdcDateType TradingDay;
///登录成功时间
TFfexFtdcTimeType LoginTime;
///最大本地报单号
TFfexFtdcOrderLocalIDType MaxOrderLocalID;
///交易顾客代码
TFfexFtdcUserIDType UserID;
///会员代码
TFfexFtdcParticipantIDType ParticipantID;
};
pRspInfo：返回顾客响应信息的地址。特别注旨在有持续的成功的响应数据时，中间有也许返回NULL，但第一次不会，如下同。错误代码为0时，表达操作成功，如下同。
响应信息构造：
struct CFfexFtdcRspInfoField
{
///错误代码
TFfexFtdcErrorIDType ErrorID;
///错误信息
TFfexFtdcErrorMsgType ErrorMsg;
};
nRequestID：返回顾客登录祈求的ID，该ID由顾客在登录时指定。
bIsLast：批示该次返回与否为针对nRequestID的最后一次返回。