sqlsrv_free_stmt

Descargar controlador PHP

Libera todos los recursos asociados con la instrucción especificada. La instrucción no se puede utilizar de nuevo después de llamar a esta función.

Sintaxis

  
sqlsrv_free_stmt( resource $stmt)  

Parámetros

$stmt: la instrucción que se va a cerrar.

Valor devuelto

Se devuelve el valor booleano True , salvo que se llame a la función con un parámetro no válido. En este caso, se devolverá False .

Nota

Null es un parámetro válido para esta función. Esto permite que se llame varias veces a la función en un script. Por ejemplo, si libera una instrucción en una condición de error y la vuelve a liberar al final del script, la segunda llamada a sqlsrv_free_stmt devuelve true debido a que la primera llamada a sqlsrv_free_stmt (en la condición de error) establece el recurso de instrucción en null.

Ejemplo

En el ejemplo siguiente se crea un recurso de instrucción, se ejecuta una consulta sencilla y se llama a sqlsrv_free_stmt para liberar todos los recursos asociados con la instrucción. En el ejemplo se da por hecho que SQL Server y la base de datos AdventureWorks están instalados en el equipo local. Los resultados se agregan a la consola cuando se ejecuta el ejemplo en la línea de comandos.

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

Consulte también

Referencia de API del controlador SQLSRV

Sobre los ejemplos de código de la documentación

sqlsrv_cancel