sqlsrv_cancel()函数—用法及示例

函数名称：sqlsrv_cancel()

适用版本：PHP 5.2.0及以上版本

函数描述：sqlsrv_cancel()函数用于取消正在执行的SQL语句。

语法：bool sqlsrv_cancel ( resource $stmt )

参数：

• $stmt：必需，表示 SQL 语句的执行句柄（statement handle），通过 sqlsrv_query() 或 sqlsrv_prepare() 函数返回的。

返回值：

• 成功时返回 true，表示成功取消了 SQL 语句的执行。
• 失败时返回 false，表示取消操作失败。

示例代码：

<?php
$serverName = "serverName\sqlexpress";
$connectionOptions = array(
    "Database" => "dbName",
    "Uid" => "username",
    "PWD" => "password"
);

$conn = sqlsrv_connect($serverName, $connectionOptions);

if ($conn === false) {
    die(print_r(sqlsrv_errors(), true));
}

$sql = "SELECT * FROM tableName";
$stmt = sqlsrv_query($conn, $sql);

if ($stmt === false) {
    die(print_r(sqlsrv_errors(), true));
}

// 取消正在执行的 SQL 语句
if (sqlsrv_cancel($stmt)) {
    echo "取消成功！";
} else {
    echo "取消失败！";
}

sqlsrv_close($conn);
?>

上述示例代码展示了如何使用sqlsrv_cancel()函数取消正在执行的SQL语句。首先，我们建立了与数据库的连接，然后使用sqlsrv_query()函数执行了一条SELECT语句，并将执行句柄存储在$stmt变量中。接下来，我们调用sqlsrv_cancel()函数来取消正在执行的SQL语句，并根据返回值判断取消操作是否成功。最后，使用sqlsrv_close()函数关闭与数据库的连接。

请注意，为了正确使用sqlsrv_cancel()函数，你需要在运行此函数之前先执行sqlsrv_query()或sqlsrv_prepare()函数获取到SQL语句的执行句柄。