sqlsrv_free_stmt

Scaricare il driver PHP

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

Vedere anche

Riferimento all'API del driver SQLSRV

Informazioni sugli esempi di codice nella documentazione

sqlsrv_cancel