5.4.30 mysql_get_option()

int
mysql_get_option(MYSQL *mysql,
                 enum mysql_option option,
                 const void *arg)

Описание

Возвращает текущее значение параметра, устанавливаемого с помощью mysql_options(). Значение должно рассматриваться как неизменяемое.

Аргумент option — это параметр, для которого требуется его значение. Аргумент arg — указатель на переменную, в которой нужно сохранить значение параметра. arg должен быть указателем на переменную соответствующего типа для аргумента option. Следующая таблица показывает, какую переменную использовать для каждого значения option.

Для MYSQL_OPT_MAX_ALLOWED_PACKET, можно установить максимальный размер сеансового или глобального буфера, в зависимости от того, является ли аргумент mysql к mysql_options() не-NULL или NULL, mysql_get_option() аналогично возвращает сеансовое или глобальное значение в зависимости от его аргумента mysql.

Тип `arg`	Применимые значения `option`
`unsigned int`	`MYSQL_OPT_CONNECT_TIMEOUT`, `MYSQL_OPT_PROTOCOL`, `MYSQL_OPT_READ_TIMEOUT`, `MYSQL_OPT_RETRY_COUNT`, `MYSQL_OPT_SSL_MODE`, `MYSQL_OPT_WRITE_TIMEOUT`
`unsigned long`	`MYSQL_OPT_MAX_ALLOWED_PACKET`, `MYSQL_OPT_NET_BUFFER_LENGTH`
`my_bool`	`MYSQL_ENABLE_CLEARTEXT_PLUGIN`, `MYSQL_OPT_CAN_HANDLE_EXPIRED_PASSWORDS`, `MYSQL_OPT_GET_SERVER_PUBLIC_KEY`, `MYSQL_OPT_GUESS_CONNECTION`, `MYSQL_OPT_LOCAL_INFILE`, `MYSQL_OPT_RECONNECT`, `MYSQL_OPT_SSL_ENFORCE`, `MYSQL_OPT_SSL_VERIFY_SERVER_CERT`, `MYSQL_OPT_USE_EMBEDDED_CONNECTION`, `MYSQL_OPT_USE_REMOTE_CONNECTION`, `MYSQL_REPORT_DATA_TRUNCATION`, `MYSQL_SECURE_AUTH`
`const char *`	`MYSQL_DEFAULT_AUTH`, `MYSQL_OPT_BIND`, `MYSQL_OPT_SSL_CA`, `MYSQL_OPT_SSL_CAPATH`, `MYSQL_OPT_SSL_CERT`, `MYSQL_OPT_SSL_CIPHER`, `MYSQL_OPT_SSL_CRL`, `MYSQL_OPT_SSL_CRLPATH`, `MYSQL_OPT_SSL_KEY`, `MYSQL_OPT_TLS_VERSION`, `MYSQL_PLUGIN_DIR`, `MYSQL_READ_DEFAULT_FILE`, `MYSQL_READ_DEFAULT_GROUP`, `MYSQL_SERVER_PUBLIC_KEY`, `MYSQL_SET_CHARSET_DIR`, `MYSQL_SET_CHARSET_NAME`, `MYSQL_SET_CLIENT_IP`, `MYSQL_SHARED_MEMORY_BASE_NAME`
аргумент не используется	`MYSQL_OPT_COMPRESS`
не может быть запрошен (возвращается ошибка)	`MYSQL_INIT_COMMAND`, `MYSQL_OPT_CONNECT_ATTR_DELETE`, `MYSQL_OPT_CONNECT_ATTR_RESET`, `MYSQL_OPT_NAMED_PIPE`

Значения возврата

Ноль в случае успеха. Неноль, если произошла ошибка; это происходит для значений option, которые не могут быть запрошены.

Пример

Следующий вызов проверяет параметр MYSQL_OPT_LOCAL_INFILE. После успешного возврата вызова, значение infile будет истинным или ложным, чтобы указать, включен ли local_infile.

bool infile;

if (mysql_get_option(mysql, MYSQL_OPT_LOCAL_INFILE, &infile))
  fprintf(stderr, "mysql_get_option() failed\n");