sqlsrv_free_stmt

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

sqlsrv_free_stmtLibera 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

Devuelve true en caso de éxito o false en caso de 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

add a note

User Contributed Notes 1 note

up
0
Anonymous
10 years ago
If you accidentally call this with an invalid $stmt resource, you may see unexpected fatal errors.

I had left behind a call here when cleaning up some code and this caused the my IIS server to generate an error 500 resource not found error. Furthermore it seemed to only affect some users and not all and I could not isolate why only selected users got the error when it was called for all users.
To Top