| Home | Libraries | People | FAQ | More

#### client_errc

MySQL client-defined error codes.

##### Synopsis

Defined in header `<boost/mysql/client_errc.hpp>`

    enum class client_errc
        : int;

##### Values

Name | Description
--- | ---
`incomplete_message` | An incomplete message was received from the server (indicates a deserialization error or packet mismatch).
`protocol_value_error` | An unexpected value was found in a server-received message (indicates a deserialization error or packet mismatch).
`server_unsupported` | The server does not support the minimum required capabilities to establish the connection.
`extra_bytes` | Unexpected extra bytes at the end of a message were received (indicates a deserialization error or packet mismatch).
`sequence_number_mismatch` | Mismatched sequence numbers (usually caused by a packet mismatch).
`unknown_auth_plugin` | The user employs an authentication plugin not known to this library.
`auth_plugin_requires_ssl` | (Legacy) The authentication plugin requires the connection to use SSL. This code is no longer used, since all supported plugins support plaintext connections.
`wrong_num_params` | The number of parameters passed to the prepared statement does not match the number of actual parameters.
`server_doesnt_support_ssl` | The connection mandates SSL, but the server doesn't accept SSL connections.
`metadata_check_failed` | The static interface detected a mismatch between your C++ type definitions and what the server returned in the query.
`num_resultsets_mismatch` | The static interface detected a mismatch between the number of row types passed to `static_results` or `static_execution_state` and the number of resultsets returned by your query.
`row_type_mismatch` | The `StaticRow` type passed to read_some_rows does not correspond to the resultset type being read.
`static_row_parsing_error` | The static interface encountered an error when parsing a field into a C++ data structure.
`pool_not_running` | Getting a connection from a connection_pool was cancelled before the pool was run. Ensure that you're calling connection_pool::async_run.
`pool_cancelled` | Getting a connection from a connection_pool failed because the pool was cancelled.
`no_connection_available` | Getting a connection from a connection_pool was cancelled before a connection was available.
`invalid_encoding` | An invalid byte sequence was found while trying to decode a string.
`unformattable_value` | A formatting operation could not format one of its arguments.
`format_string_invalid_syntax` | A format string containing invalid syntax was provided to a SQL formatting function.
`format_string_invalid_encoding` | A format string with an invalid byte sequence was provided to a SQL formatting function.
`format_string_manual_auto_mix` | A format string mixes manual (e.g. {0}) and automatic (e.g. {}) indexing.
`format_string_invalid_specifier` | The supplied format specifier (e.g. {:i}) is not supported by the type being formatted.
`format_arg_not_found` | A format argument referenced by a format string was not found. Check the number of format arguments passed and their names.
`unknown_character_set` | The character set used by the connection is not known by the client. Use `any_connection::set_character_set` or `any_connection::async_set_character_set` before invoking operations that require a known charset.
`max_buffer_size_exceeded` | An operation attempted to read or write a packet larger than the maximum buffer size. Try increasing `any_connection_params::max_buffer_size`.
`operation_in_progress` | Another operation is currently in progress for this connection. Make sure that a single connection does not run two asynchronous operations in parallel.
`not_connected` | The requested operation requires an established session. Call `async_connect` before invoking other operations.
`engaged_in_multi_function` | The connection is currently engaged in a multi-function operation. Finish the current operation by calling `async_read_some_rows` and `async_read_resultset_head` before starting any other operation.
`not_engaged_in_multi_function` | The operation requires the connection to be engaged in a multi-function operation. Use `async_start_execution` to start one.
`bad_handshake_packet_type` | During handshake, the server sent a packet type that is not allowed in the current state (protocol violation).
`unknown_openssl_error` | An OpenSSL function failed and did not provide any extra diagnostics.

##### Description

These errors are produced by the client itself, rather than the server.

Convenience header `<boost/mysql.hpp>`