sqlsrv_free_stmt
Libère toutes les ressources associées à l’instruction spécifiée. L’instruction ne peut pas être réutilisée une fois que cette fonction a été appelée.
Syntaxe
sqlsrv_free_stmt( resource $stmt)
Paramètres
$stmt: instruction à fermer.
Valeur de retour
Valeur booléenne true sauf si la fonction est appelée avec un paramètre non valide. Si la fonction est appelée avec un paramètre non valide, false est retourné.
Notes
Null est un paramètre valide pour cette fonction. Ainsi, la fonction peut être appelée plusieurs fois dans un script. Par exemple, si vous libérez une instruction dans une condition d’erreur et que vous la libérez à nouveau à la fin du script, le deuxième appel à sqlsrv_free_stmt retourne true car le premier appel à sqlsrv_free_stmt (dans la condition d’erreur) affecte la valeur null à la ressource d’instruction.
Exemple
L’exemple suivant crée une ressource d’instruction, exécute une requête simple et appelle sqlsrv_free_stmt pour libérer toutes les ressources associées à l’instruction. L’exemple part du principe que SQL Server et la base de données AdventureWorks sont installés sur l’ordinateur local. Toute la sortie est écrite dans la console quand l’exemple est exécuté à partir de la ligne de commande.
<?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);
?>
Voir aussi
Informations de référence sur l’API du pilote SQLSRV