27.7.6.70 mysql_set_server_option()

int mysql_set_server_option(MYSQL *mysql, enum enum_mysql_set_option option)

Description

启用或禁用连接选项。 option可以具有以下值之一。

Option	Description
MYSQL_OPTION_MULTI_STATEMENTS_ON	启用多语句支持
MYSQL_OPTION_MULTI_STATEMENTS_OFF	禁用多语句支持

如果启用了多语句支持，则应该使用调用mysql_next_result()的循环来确定是否有更多结果，从而从对mysql_query()或mysql_real_query()的调用中检索结果。有关示例，请参见第 27.7.15 节“ C API 多语句执行支持”。

通过MYSQL_OPTION_MULTI_STATEMENTS_ON启用多语句支持与通过将CLIENT_MULTI_STATEMENTS标志传递到mysql_real_connect()来启用它的效果并不完全相同：CLIENT_MULTI_STATEMENTS也会启用CLIENT_MULTI_RESULTS。如果您在程序中使用CALL SQL 语句，则必须启用多结果支持；否则，请启用。这意味着MYSQL_OPTION_MULTI_STATEMENTS_ON本身不足以允许使用CALL。

Return Values

零成功。如果发生错误，则为非零值。

Errors

• CR_COMMANDS_OUT_OF_SYNC

命令执行 Sequences 不正确。

• CR_SERVER_GONE_ERROR

MySQL 服务器已经消失了。

• CR_SERVER_LOST

在查询期间与服务器的连接已丢失。

• ER_UNKNOWN_COM_ERROR

服务器不支持mysql_set_server_option()(这是服务器早于 4.1.1 的情况)，或者服务器不支持试图设置的选项。