sqlsrv_free_stmt
释放与指定语句相关联的所有资源。 在调用此函数后,无法再次使用该语句。
语法
sqlsrv_free_stmt( resource $stmt)
parameters
$stmt:要关闭的语句。
返回值
除非使用无效参数调用该函数,否则布尔值为 true 。 如果使用无效参数调用该函数,将返回 False 。
注意
对于此函数,Null 是有效参数。 这允许在脚本中调用该函数多次。 例如,当在错误条件中释放某个语句,并且在脚本结尾再次释放时,第二次对 sqlsrv_free_stmt 的调用将返回 true,因为第一次对 sqlsrv_free_stmt 的调用(在错误条件中)将语句资源设置为 null。
示例
以下示例创建某个语句资源、执行一次简单的查询,并调用 sqlsrv_free_stmt 来释放与该语句相关联的所有资源。 该示例假定已在本地计算机上安装了 SQL Server 和 AdventureWorks 数据库。 从命令行运行该示例时,所有输出都将写入控制台。
<?php
/* Connect to the local server using Windows Authentication and
specify the AdventureWorks database as the database in use. */
$serverName = "(local)";
$connectionInfo = array( "Database"=>"AdventureWorks");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false )
{
echo "Could not connect.\n";
die( print_r( sqlsrv_errors(), true));
}
$stmt = sqlsrv_query( $conn, "SELECT * FROM Person.Contact");
if( $stmt )
{
echo "Statement executed.\n";
}
else
{
echo "Query could not be executed.\n";
die( print_r( sqlsrv_errors(), true));
}
/*-------------------------------
Process query results here.
-------------------------------*/
/* Free the statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>