int mysql_set_server_option(MYSQL *mysql, enum
enum_mysql_set_option option)
説明
接続の為のオプションを有効にしたり無効にしたりします。option
に以下の値を持たせることができます。
MYSQL_OPTION_MULTI_STATEMENTS_ON | マルチステートメントサポートを有効化します。 |
MYSQL_OPTION_MULTI_STATEMENTS_OFF | マルチステートメントサポートを無効化します。 |
マルチ・ステートメントサポートを有効化する場合、呼び出し結果を、mysql_next_result()
を呼び出して、更なる結果が存在しないか査定するループを使って、mysql_query()
またはmysql_real_query()
に複写すべきです。(例については、項23.2.9. 「マルチプルステートメントを実行する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
の使用を許すには不十分であることを意味します。
戻り値
成功のためのゼロ。エラーが起こった場合、ゼロ以外。
エラー
CR_COMMANDS_OUT_OF_SYNC
コマンドが妥当でないオーダーで実行されました。
CR_SERVER_GONE_ERROR
MySQLサーバが立ち去りました。
CR_SERVER_LOST
サーバへの接続がクエリー中に失われました。
ER_UNKNOWN_COM_ERROR
サーバがmysql_set_server_option()
をサポートしなかった
(そのサーバが4.1.1より古いかった場合)もしくはサーバがセットしようと努めたオプションをサポートしなかった。