|
Spec-Zone .ru
спецификации, руководства, описания, API
|
int mysql_options4(MYSQL *mysql, enum mysql_option option, const void *arg1, const void
*arg2)
mysql_options4() подобно mysql_options() но имеет дополнительный четвертый параметр так, чтобы два
значения можно было передать для опции, определенной во втором параметре. Эта функция была добавлена в MySQL
5.6.6.
Следующий список описывает разрешенные опции, их эффект, и как arg1 и arg2 используются.
MYSQL_OPT_CONNECT_ATTR_ADD (типы параметра: char *, char *)
Эта опция добавляет пару ключ/значение к текущему набору атрибутов соединения, которые передадут к серверу во время соединения. Обоими параметрами являются указатели на завершенные нулем строки. Первые и вторые строки указывают на ключ и значение, соответственно. Если ключ уже существует в текущем наборе атрибутов соединения, новое значение заменяет существующий. Сравнение ключевого имени с существующими ключами является чувствительным к регистру.
Ключевые имена, которые начинаются с подчеркивания (_) резервируются
для внутреннего пользования и не должен использоваться прикладными программами.
См. также описания для MYSQL_OPT_CONNECT_ATTR_RESET MYSQL_OPT_CONNECT_ATTR_DELETE опции в описании mysql_options() функция.
Атрибуты соединения представляются через session_connect_attrs и session_account_connect_attrs Таблицы Схемы производительности. См.
Раздел 21.9.7, "Таблицы
атрибутов Соединения Схемы Производительности".
Нуль для успеха. Ненулевой, если Вы определяете неизвестную опцию.
Этот пример демонстрирует вызовы, которые определяют атрибуты соединения:
MYSQL mysql;mysql_init(&mysql);mysql_options4(&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_options4(&mysql,MYSQL_OPT_CONNECT_ATTR_DELETE, "key1");if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0)){ fprintf(stderr, "Failed to connect to database: Error: %s\n", mysql_error(&mysql));}mysql_options(&mysql,MYSQL_OPT_CONNECT_ATTR_RESET, 0);