10bet网址
MySQL 5.6 C API开发指南
本手册下载
PDF (Ltr)- 1.1 mb
PDF (A4)- 1.1 mb
HTML下载(TGZ)- 135.1 kb
HTML下载(邮政编码)- 144.7 kb


5.4.50 mysql_options4 ()

int mysql_option4 (MYSQL * MYSQL, enum mysql_option option, const void *arg1, const void *arg2)

描述

mysql_options4 ()类似于mysql_options ()但是有一个额外的第四个参数,因此可以为第二个参数中指定的选项传递两个值。

下面的列表描述了允许的选项、它们的效果以及如何使用__arg1最长使用。

  • MYSQL_OPT_CONNECT_ATTR_ADD(参数类型:Char *, Char *)

    此选项将属性键值对添加到当前连接属性集,以便在连接时传递给服务器。两个参数都是指向以空结束的字符串的指针。第一个和第二个字符串分别表示键和值。如果该键为空或当前连接属性集中已经存在,则会发生错误。键名与现有键的比较是区分大小写的。

    以下划线开头的键名(_)保留给内部使用,不应该由应用程序创建。这个约定允许MySQL引入新的属性,而不会与应用程序属性发生冲突。

    mysql_options4 ()将其接受的连接属性数据的聚合大小限制为64KB。对于导致超出此限制的调用,请使用CR_INVALID_PARAMETER_NO发生错误。属性大小限制检查也在服务器端进行。有关详细信息,请参见性能模式连接属性表,它还描述了Performance Schema如何通过session_connect_attrssession_account_connect_attrs表。

    控件的描述也请参阅MYSQL_OPT_CONNECT_ATTR_RESETMYSQL_OPT_CONNECT_ATTR_DELETE的描述中的选项mysql_options ()函数。

返回值

成功的为零。如果指定未知选项,则为非零。

错误

例子

这个例子演示了指定连接属性的调用:

mysql mysql;mysql_init(&mysql);mysql_options(&mysql,mysql_opt_connect_attr_reset,0);mysql_options4(&mysql,mysql_opt_connect_attr_add,“key1”,“value1”);mysql_options4(&mysql,mysql_opt_connect_attr_add,“key2”,“value2”);mysql_options4(&mysql,mysql_opt_connect_attr_add,“key3”,“value3”);mysql_options(&mysql,mysql_opt_connect_attr_delete,“key1”);if(!mysql_real_connect(&mysql,host“,”用户“,”passwd{fprintf(stderr, "Failed to connect to database: Error: %s\n", mysql_error(&mysql)); / /连接数据库失败}