(No version information available, might only be in SVN)
sqlsrv_free_stmt — Libère toutes les ressources de la requête spécifiée
$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.
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.
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
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);
?>
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.