array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.sqlsrv-free-stmt.php', 1 => 'sqlsrv_free_stmt', 2 => 'Libera todos os recursos para a declaração especificada', ), 'up' => array ( 0 => 'ref.sqlsrv.php', 1 => 'Funções SQLSRV', ), 'prev' => array ( 0 => 'function.sqlsrv-field-metadata.php', 1 => 'sqlsrv_field_metadata', ), 'next' => array ( 0 => 'function.sqlsrv-get-config.php', 1 => 'sqlsrv_get_config', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/sqlsrv/functions/sqlsrv-free-stmt.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sqlsrv_free_stmt

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

sqlsrv_free_stmt — Libera 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