sqlsrv_free_stmt
Libera todos los recursos asociados con la instrucción especificada. No se puede volver a usar la instrucción después de llamar a esta función.
Sintaxis
sqlsrv_free_stmt( resource $stmt)
Parámetros
$stmt: Instrucción que se va a cerrar.
Valor devuelto
El valor booleano true a menos que se llame a la función con un parámetro no válido. Si se llama a la función con un parámetro no válido, se devuelve false.
Nota
Null es un parámetro válido para esta función. Esto permite que se llame a la función varias veces en un script. Por ejemplo, si se libera una instrucción en una condición de error y se vuelve a liberar al final del script, la segunda llamada a sqlsrv_free_stmt devolverá true, puesto 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 simple y se llama a sqlsrv_free_stmt para liberar todos los recursos asociados con la instrucción. En el ejemplo se supone que SQL Server y la base de datos AdventureWorks están instalados en el equipo local. Todos los resultados se escriben en la consola cuando el ejemplo se ejecuta desde 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);
?>
Vea también
Referencia
Conceptos
Acerca de ejemplos de código en la documentación