sqlsrv_free_stmt

(No version information available, might only be in Git)

sqlsrv_free_stmt — Libera todos los recursos de la consulta especificada

Descripción

sqlsrv_free_stmt(resource $stmt): bool

Libera todos los recursos para la consulta especificada. La consulta no podrá ser utilizada después de pasar a la función sqlsrv_free_stmt(). Si la función sqlsrv_free_stmt() es llamada mientras la consulta está en ejecución, la ejecución de la consulta es interrumpida y la consulta es cancelada.

Parámetros

stmt
La consulta cuyos recursos serán liberados. Tenga en cuenta que null es un valor de argumento válido. Este valor permite que la función sea llamada varias veces en un script.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Ejemplos

Ejemplo #1 Ejemplo con 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));
}

/*-------------------------------
Uso de la consulta aquí.
-------------------------------*/

/* Liberación de los recursos asociados a la consulta. */
sqlsrv_free_stmt( $stmt);

?>

Notas

La principal diferencia entre la función sqlsrv_free_stmt() y la función sqlsrv_cancel() es que un recurso de consulta cancelado con la función sqlsrv_cancel() puede ser re-ejecutado si ha sido creado con la función sqlsrv_prepare(). Un recurso de consulta cancelado con la función sqlsrv_free_statement() no puede ser re-ejecutado.

Ver también