MySQL :: MySQL 9.5 C API Developer Guide

MySQL 9.5 C API Developer Guide / ... / mysql_kill()

5.4.43 mysql_kill()

int
mysql_kill(MYSQL *mysql,
           unsigned long pid)

Description

Note

mysql_kill() is deprecated and is subject to removal in a future version of MySQL. Instead, use mysql_real_query() or mysql_query() to execute a KILL statement.

Asks the server to kill the thread specified by pid.

mysql_kill() cannot handle values larger than 32 bits; to guard against killing the wrong thread, the function raises CR_INVALID_CONN_HANDLE if given an ID larger than 32 bits.

Return Values

Zero for success. Nonzero if an error occurred.

Errors

CR_COMMANDS_OUT_OF_SYNC

Commands were executed in an improper order.
CR_INVALID_CONN_HANDLE

The pid was larger than 32 bits.
CR_SERVER_GONE_ERROR

The MySQL server has gone away.
CR_SERVER_LOST

The connection to the server was lost during the query.
CR_UNKNOWN_ERROR

An unknown error occurred.

PREV HOME UP NEXT