sqlsrv_free_stmt
(No version information available, might only be in SVN)
sqlsrv_free_stmt — Libère toutes les ressources de la requête spécifiée
Description
$stmt
)Libère toutes les ressources pour la requête spécifié. La requête ne pourra plus être utilisé 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. Notez 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 dde la requête ici. -------------------------------*/ /* Libération des ressources associées à la requête. */ sqlsrv_free_stmt( $stmt); ?>
Notes
La principale différentre 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.