sqlsrv_free_stmt

Статья
01/02/2025

Освобождает все ресурсы, связанные с указанной инструкцией. Инструкцию нельзя использовать повторно после вызова этой функции.

Синтаксис

  
sqlsrv_free_stmt( resource $stmt)

Параметры

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

См. также

Справочник по API для драйвера SQLSRV

Информация о примерах кода в документации

sqlsrv_cancel

Поделиться через