普通函数
int mosquitto_lib_init( void )必须在任何其他mosquito函数之前调用。
此函数不是线程安全的。也就是说mosquitto要第一个使用,返回值总是
MOSQ_ERR_SUCCESS
struct mosquitto *mosquitto_new( const char * id, bool clean_session, void * obj )创建一个新的客户端实例,第一个参数id为客户端的clientid,第二个参数设置为true指示代理在断开连接时清除所有消息和订阅,设置为false指示代理保留它们。如果id参数为NULL,则必须将其设置为true,第三个参数将作为参数传递给指定的任何回调的用户指针。后面传进回调函数的指针
int mosquitto_lib_cleanup( void )释放调用的资源和相关的库,返回值总是为MOSQ_ERR_SUCCESS
void mosquitto_destroy( struct mosquitto * mosq )用于释放与mosquitto客户端实例关联的内存,第一个参数为mosquitto创建实例返回的mosq指针。
int mosquitto_username_pw_set( struct mosquitto * mosq, const char * username, const char * password )配置mosquito实例的用户名和密码。默认情况下,不会发送用户名或密码。对于v3.1和v3.1.1客户端,如果username为NULL,则忽略password参数。在调用mosquitto\u connect之前必须调用此函数。如果代理支持无用户密码的连接可以不使用此函数
。第一个参数为mosquitto_new的返回值,第二个为用户名,第三个为密码。返回值:
MOSQ_ERR_SUCCESS 成功。