tcp客户端上传文件 c语言,设计一个基本的TCP数据传输客户端程序，实现DAQ采集后的数据通过网络传输到另外一台电脑...

数据中心动态库说明

1、数据类型

typedef UINT u32t;

typedef UCHAR u8t;

typedef USHORT u16t;

typedef ULONGu64t;

2、数据结构

1)用以区分标识各台DTU的数据结构

typedef struct _modem_info_t_

{

u32tm_modemId;     //Modem模块的ID号

u8tm_phoneno[12];//Modem的11位电话号码，必须以'\0'字符结尾

u8tm_dynip[4];//Modem的4位动态ip地址

u64tm_conn_time; //Modem模块最后一次建立TCP连接的时间

u64tm_refresh_time;//Modem模块最后一次收发数据的时间

} ModemInfoStruct;

2)DTU数据包的数据结构

#define MAX_RECEIVE_BUF 1450

typedef struct _modem_data_t

{

u32tm_modemId;     // Modem模块的ID号

u64tm_recv_time;//接收到数据包的时间

u8t m_data_buf[MAX_RECEIVE_BUF+1];//存储接收到的数据

u16t m_data_len;//接收到的数据包长度

u8t     m_data_type;          //接收到的数据包类型,

//0x01：用户数据包

//0x02：对控制命令帧的回应

}ModemDataStruct;

以上u64t类型的时间是基于GMT时间1970年1月1日0:00:000以来的秒数指示时间值,即当前时间距1970年1月1日0点0分0秒以秒为单位的数值。在大多数语言都提供转换函数。

3、API函数说明

1)BOOL DSStartService(u16t uiListenPort);

功能：启动服务器的数据服务

参数：u16ListenPort:服务的侦听端口

返回：成功返回TRUE，失败返回FALSE；

说明：启动服务器的数据服务。启动数据服务后，服务器侦听在指定端口。

如果失败了，可以调用DSGetLastError()函数查看错误原因。

2)BOOL DSStopService(void);

功能：停止服务器的数据服务

参数：无

返回：成功返回TRUE，失败返回FALSE；

说明：停止服务器的数据服务。所有的DTU都将下线。

如果失败了，可以调用DSGetLastError()函数查看错误原因。

3)BOOL DSGetNextData(ModemDataStruct* pDataStruct, u16t waitseconds);

功能：读取下一条DTU送上来的信息

参数：pDataStruct: 存放DTU所送上来的信息和数据的结构，读函数执行成功后，返回的数据存放到该参数指向的结构中

waitseconds:本函数读到数据后立即返回；如果没有数据到达，则等待最长waitseconds(时间单位：秒)的时间，直到有数据到达,取值范围从0~65535，如果取值为0表明本函数将立即返回。另外，当在另一个线程中执行成功了DSStopService()后,本函数将立即返回。

返回：成功返回TRUE，失败返回FALSE；

说明：如果失败了，可以调用DSGetLastError()函数查看错误原因。

4)BOOL DSSendData(u32t modemId, u16t len, u8t * buf);

功能：向指定ID号的的DTU发送数据

参数：modemId:DTU的ID号，用以标识一个DTU

len:待发送的数据长度(字节数)，数据长度必须小于或等于1450个字节

buf:待发送的数据

返回：成功返回TRUE，失败返回FALSE；

说明：如果失败了，可以调用DSGetLastError()函数查看错误原因。

5)BOOL DSSendControl(u32t modemId, u16t len, u8t * buf);

功能：向指定ID号的的DTU发送控制命令

参数：modemId:DTU的ID号，用以标识一个DTU

len:待发送的控制命令长度(字节数)，数据长度必须小于或等于1000个字节

buf:待发送的控制命令帧

返回：成功返回TRUE，失败返回FALSE

说明：如果失败了，可以调用DSGetLastError()函数查看错误原因。]

6)u32t DSGetModemCount(void);

功能：取得当前在线的所有的DTU的总数

参数：无

返回：得到在线的DTU的数量

7)BOOL DSGetModemByPosition(u32t pos, ModemInfoStruct *pModemInfo);

功能：取得指定位置的DTU的数据；

参数：pos:DTU列表中的位置信息,0代表第一个DTU位置;

pModemInfo:指向用以保存DTU信息的数据结构;

返回：成功返回TRUE，失败返回FALSE

说明：如果失败了，可以调用DSGetLastError()函数查看错误原因。

一般来说DSGetDtuCount()和DSGetDtuByPosition()函数配合使用，用以查看当前所有DTU的信息，如下例所示：

u32tuiDtuCount;

uiDtuCount = DSGetDtuCount();

DtuInfoStructdtuInfo;

u32ti;

for (i = 0; i < uiDtuCount; i++)

{

DSGetDtuByPosition (i, &dtuInfo);

//对dtuInfo进行操作

}

8)void DSGetLastError(char *str, int nMaxBufSize);

功能：获得先前API执行时发生的错误；

参数：str:用来存放错误信息的缓冲区；

nMaxStrSize:缓冲区的最大长度，如果错误信息的大小超过了这个值，则此函数将把错误信息的尾部截除。

返回：无

9)BOOL DSDisconnect(u32t modemId);

功能：断开指定ID号的DTU连接

参数：modemId: DTU的ID号，用以标识一个DTU

返回：成功返回TRUE，失败返回FALSE

说明：如果失败了，可以调用DSGetLastError()函数查看错误原因。

4、函数的具体使用

3)导入动态库

调用WINDOWS API函数LoadLibrary装载动态库，如下：

HMODULEDllMudule;             //指向动态库的句柄

BOOL (*DSStartService)(u16t); //定义一个指向函数的地址的指针

hDllModule = LoadLibrary(“gprsdll.dll”);

If (hDllModule != NULL)    //判断调用是否成功

{

//从动态库中取函数地址

DSStartService = GetProcAddress(hDllModule,”DSStartService”);

if (DSStartService != NULL)   //判断是否取到该函数地址

{

if ((*DSStartService)( 5001) != FALSE)

MessageBox(“启动成功”);

Else

MessageBox(“启动失败”);

}

}

在程序开始时需要调用动态库，程序运行完毕后，要释放动态库，调用windows API函数FreeLibrary可释放动态库：

FreeLibrary(hDllModule);   //TRUE-success  FALSE-failed

程序中LoadLibrary次数必须和FreeLibrary相同，每调用一次LoadLibrary，相应的应该调用一次FreeLibrary，保证每次调用后都会释放。

4)启动服务

首先从动态库中取到该函数地址，取到地址后，就可以执行该函数，如下：

BOOL (*DSStartService)(u16t);  //定义一个指向函数的地址的指针

DSStartService = (BOOL(*)(u16t))GetProcAddress(hDllModule, “DSStartService”);

if (DSStartService != NULL)

{

(*DSStartService)( 5001);

}

5)停止服务

BOOL (*DSStopService)(void);

DSStopService = (BOOL (*)(void))GetProcAddress(hDllModule, “DSStopService”);

If (DSStopService != NULL)

(*DSStopService)();

6)读数据

BOOL DSGetNextData(ModemDataStruct*, u16t);

DSGetNextData =

(BOOL(*)(ModemDataStruct*, u16t))GetProcAddress(hDllModule, “DSGetNextData”);

if (DSGetNextData != Null)

if ((*DSGetNextData)(&dtudata, 100) == 0)  //dtudata为DtuDataStruct型结构

//如果没有数据最长等待100秒

{

//处理结构dtudata中的数据

}

7)发送数据

BOOL DSSendData (u32t, u16t, u8t *);

DSSendData = (BOOL(*)(u32t, u16t, u8t*))GetProcAddress(hDllModule, “DSSendData”);

if (DSSendData != NULL)

{

(*DSSendData)(nID, len, buf);

}

8)用户列表

底层服务维护一张用户列表，记录当前在线用户的信息，DSC如果想知道底层用户列表，需要调用提供的API函数：DSGetModemCount、DSGetModemByPosition

for (u32t i = 0; i < (*DSGetModemCount)(); i++)

{

(*DSGetModemByPosition)(i, &dtuinfo);

//1、处理记录用户信息记录dtuinfo中的信息；

}

9)错误信息

可以通过调用DSGetLastError()函数来获得上次调用API函数失败后的具体的错误信息。

char szErrorMsg[256];

DSGetLastError(szErrorMsg, 255);

这个是厦门才茂DTU动态库文件，如果需要咨询更详细，可以直接联系厦门才茂技术，或者直接到他们网站咨询