Paho -物联网 MQTT C Cient的实现和详解 (4)

作用:此函数尝试使用指定的选项将先前创建的客户端连接到MQTT服务器。

参数 含义
handle   指向MQTT客户端句柄的指针。句柄被成功从函数中返回的客户端引用所填充  
options   指向有效的MQTTClient_connectOptions结构的指针。  
> 返回值
0   连接成功  
1   拒绝连接:不可接受的协议版本。  
2   拒绝连接:标识符被拒绝。  
3   拒绝连接:服务器不可用。  
4   拒绝连接:用户名或密码错误。  
5   拒绝连接:未经授权。  
6   保留给未来用。  
MQTTClient_subscribe

定义:

DLLExport int MQTTClient_subscribe ( MQTTClient handle, const char * topic, int qos )

作用:此功能尝试将客户订阅到单个主题,该主题可能包含通配符。 此函数还指定服务质量。

参数 含义
handle   指向MQTT客户端句柄的指针。句柄被成功从函数中返回的客户端引用所填充  
topic   订阅的主题,可使用通配符。  
qos   订阅的请求服务质量  
MQTTClient_publishMessage

定义:

DLLExport int MQTTClient_publishMessage ( MQTTClient handle, const char * topicName, MQTTClient_message * msg, MQTTClient_deliveryToken * dt )

作用:此功能尝试将客户订阅到单个主题,该主题可能包含通配符。 此函数还指定服务质量。

参数 含义
handle   指向MQTT客户端句柄的指针。句柄被成功从函数中返回的客户端引用所填充  
topicName   与信息相关的主题。  
msg   指向有效的 MQTTClient_message 结构的指针, 其中包含要发布消息的有效负载和属性  
dt   指向MQTTClient_deliveryToken的指针。当函数成功返回时,dt会被赋值为代表消息的token。如果程序中没有使用传递token,将其设置为NULL。  
MQTTClient_waitForCompletion

定义:

DLLExport int MQTTClient_waitForCompletion ( MQTTClient handle, MQTTClient_deliveryToken dt, unsigned long timeout )

作用:客户端应用程序调用此函数来将主线程的执行与消息的完成发布同步。 被调用时,MQTTClient_waitForCompletion()阻塞执行,直到消息成功传递或已超过指定的时间。

参数 含义
handle   指向MQTT客户端句柄的指针。句柄被成功从函数中返回的客户端引用所填充  
dt   代表消息的MQTTClient_deliveryToken用来检测是否成功传递。传递token由发布函数MQTTClient_publish () 和 MQTTClient_publishMessage ()所产生。  
timeout   等待的最大毫秒数。  

返回值:
消息成功传递则返回MQTTCLIENT_SUCCESS(0) ,如果时间已过期或检测token时出问题,则返回错误码。

  对paho客户端的讲解就到此结束了,如有不明白的,可以给我留言,一起讨论,一起进步。

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/wpjygd.html