sqlsrv_free_stmt

Télécharger le pilote PHP

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

À propos des exemples de code dans la documentation

sqlsrv_cancel