sqlsrv_free_stmt

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

sqlsrv_free_stmtLibera todos os recursos para a declaração especificada

Descrição

sqlsrv_free_stmt(resource $stmt): bool

Libera todos os recursos para a declaração especificada. A declaração não pode ser usada após sqlsrv_free_stmt() ser chamada nela. Se sqlsrv_free_stmt() for chamada em uma declaração em andamento que altera o estado do servidor, a execução da declaração é interrompida e a declaração é revertida.

Parâmetros

stmt

A declaração para a qual os recursos são liberados. Note que null é um valor de parâmetro válido. Isso permite que a função seja chamada várias vezes em um script.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo de 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));
}

/*-------------------------------
Processar os resultados da consulta aqui.
-------------------------------*/

/* Libere os recursos da declaração. */
sqlsrv_free_stmt( $stmt);

?>

Notas

A principal diferença entre sqlsrv_free_stmt() e sqlsrv_cancel() é que um recurso de declaração cancelado com sqlsrv_cancel() pode ser reexecutado se foi criado com sqlsrv_prepare(). Um recurso de declaração cancelado com sqlsrv_free_statement() não pode ser reexecutado.

Veja Também

add a note

User Contributed Notes 1 note

up
0
Anonymous
9 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