sqlsrv_free_stmt
(No version information available, might only be in Git)
sqlsrv_free_stmt — Libère toutes les ressources de la requête spécifiée
Description
Libère toutes les ressources pour la requête spécifiée. La requête ne pourra
plus être utilisée après le passage à la fonction sqlsrv_free_stmt().
Si la requête sqlsrv_free_stmt() est appelée alors que la
requête est en cours d'exécution, l'exécution de la requête est interrompue,
et la requête est annulée.
Liste de paramètres
stmt
-
La requête dont les ressources seront libérées.
Il est à noter que
null est une valeur de paramètre valide. Cette valeur
permet à la fonction d'être appelée à plusieurs reprises dans un script.
Valeurs de retour
Cette fonction retourne true en cas de succès ou false si une erreur survient.
Exemples
Exemple #1 Exemple avec sqlsrv_free_stmt()
<?php
$serverName = "serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false ) {
die( print_r( sqlsrv_errors(), true));
}
$stmt = sqlsrv_query( $conn, "SELECT * FROM Table_1");
if( $stmt === false ) {
die( print_r( sqlsrv_errors(), true));
}
/*-------------------------------
Exploitation de la requête ici.
-------------------------------*/
/* Libération des ressources associées à la requête. */
sqlsrv_free_stmt( $stmt);
?>
Notes
La principale différence entre la fonction sqlsrv_free_stmt() et
la fonction sqlsrv_cancel() est qu'une ressource de requête
annulée avec la fonction sqlsrv_cancel() peut être ré-exécutée
si elle a été créée avec la fonction sqlsrv_prepare().
Une ressource de requête annulée avec la fonction
sqlsrv_free_statement() ne peut plus être ré-exécutée.