sqlsrv_free_stmt
Libera tutte le risorse associate all'istruzione specificata. L'istruzione non potrà essere usata nuovamente dopo la chiamata a questa funzione.
Sintassi
sqlsrv_free_stmt( resource $stmt)
Parametri
$stmt: istruzione da chiudere.
Valore restituito
Valore booleano true a meno che la funzione non venga chiamata con un parametro non valido. Se la funzione viene chiamata con un parametro non valido, viene restituito false .
Nota
Null è un parametro valido per questa funzione. Permette alla funzione di essere chiamata più volte in uno script. Se ad esempio si rilascia un'istruzione in una condizione di errore e la si rilascia nuovamente alla fine dello script, la seconda chiamata a sqlsrv_free_stmt restituirà true perché la prima chiamata a sqlsrv_free_stmt (nella condizione di errore) imposta la risorsa di istruzione su Null.
Esempio
Nell'esempio seguente viene creata una risorsa di istruzione, viene eseguita una query semplice e viene eseguita una chiamata a sqlsrv_free_stmt per rilasciare tutte le risorse associate all'istruzione. Nell'esempio si presuppone che SQL Server e il database AdventureWorks siano installati nel computer locale. Quando si esegue l'esempio dalla riga di comando, tutto l'output viene scritto nel browser.
<?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);
?>
Vedi anche
Riferimento all'API del driver SQLSRV