sqlsrv_free_stmt

  • 项目

下载 PHP 驱动程序

释放与指定语句相关联的所有资源。 在调用此函数后，无法再次使用该语句。

语法

  
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);  
?>

另请参阅

SQLSRV 驱动程序 API 参考

文档中相关的代码示例

sqlsrv_cancel