7.2 C API Asynchronous Interface Data Structures — MySQL Connectors 1.0

7.2 C API Асинхронные структуры данных интерфейса

В этом разделе описываются структуры данных, специфичные для асинхронных функций C API. Сведения о структурах данных общего назначения C API см. в разделе 5.2, «Базовые структуры данных C API».

enum connect_stage

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

Значение перечисления стадии	Описание
`CONNECT_STAGE_INVALID = 0`	MYSQL недействителен или неизвестное состояние
`CONNECT_STAGE_NOT_STARTED`	Не подключено
`CONNECT_STAGE_NET_BEGIN_CONNECT`	Начало подключения к серверу
`CONNECT_STAGE_NET_WAIT_CONNECT`	Ожидание установления подключения
`CONNECT_STAGE_NET_COMPLETE_CONNECT`	Инициализация локальных структур данных после подключения
`CONNECT_STAGE_READ_GREETING`	Чтение первого пакета
`CONNECT_STAGE_PARSE_HANDSHAKE`	Парсинг первого пакета
`CONNECT_STAGE_ESTABLISH_SSL`	Установление TLS
`CONNECT_STAGE_AUTHENTICATE`	Фаза аутентификации
`CONNECT_STAGE_AUTH_BEGIN`	Определение используемого плагина
`CONNECT_STAGE_AUTH_RUN_FIRST_AUTHENTICATE_USER`	Выполнение первого плагина аутентификации
`CONNECT_STAGE_AUTH_HANDLE_FIRST_AUTHENTICATE_USER`	Обработка результата выполнения первого плагина аутентификации
`CONNECT_STAGE_AUTH_READ_CHANGE_USER_RESULT`	Чтение предполагаемой изменённой аутентификации пользователя (если таковая имеется)
`CONNECT_STAGE_AUTH_HANDLE_CHANGE_USER_REQUEST`	Проверка запроса сервера об использовании другого плагина аутентификации
`CONNECT_STAGE_AUTH_RUN_SECOND_AUTHENTICATE_USER`	Запуск процесса аутентификации повторно с использованием запрошенного сервером плагина
`CONNECT_STAGE_AUTH_INIT_MULTI_AUTH`	Запуск многофакторной аутентификации
`CONNECT_STAGE_AUTH_FINISH_AUTH`	Окончательная очистка
`CONNECT_STAGE_AUTH_HANDLE_SECOND_AUTHENTICATE_USER`	Теперь чтение результатов выполнения второго плагина
`CONNECT_STAGE_AUTH_DO_MULTI_PLUGIN_AUTH`	Вызов клиентских плагинов многофакторного метода аутентификации
`CONNECT_STAGE_AUTH_HANDLE_MULTI_AUTH_RESPONSE`	Обработка ответа от клиентских плагинов метода аутентификации
`CONNECT_STAGE_PREP_SELECT_DATABASE`	Авторизован, задана начальная база данных (если указано)
`CONNECT_STAGE_PREP_INIT_COMMANDS`	Подготовка к отправке последовательности команд `init`
`CONNECT_STAGE_SEND_ONE_INIT_COMMAND`	Отправка команды `init`, которая вызывается один раз для каждой команды `init`, пока они все не будут выполнены (или не произойдёт ошибка)
`CONNECT_STAGE_COMPLETE`	Подключено или асинхронное подключение не выполняется

enum net_async_status

Тип перечисления, используемый для выражения статуса возврата асинхронных функций C API. Следующая таблица показывает разрешённые значения статуса.

Значение перечисления статуса	Описание
`NET_ASYNC_COMPLETE`	Асинхронная операция завершена
`NET_ASYNC_NOT_READY`	Асинхронная операция всё ещё выполняется
`NET_ASYNC_ERROR`	Асинхронная операция завершилась с ошибкой
`NET_ASYNC_COMPLETE_NO_MORE_RESULTS`	Для `mysql_next_result_nonblocking()`; указывает, что больше результатов недоступно

Дополнительную информацию см. в главе 7, «Асинхронный интерфейс C API».