sqlsrv_free_stmt
Libera todos os recursos associados à instrução especificada. A instrução não pode ser usada novamente depois que essa função foi chamada.
Sintaxe
sqlsrv_free_stmt( resource $stmt)
Parâmetros
$stmt: a instrução a ser fechada.
Valor de retorno
O valor booliano true , a menos que a função seja chamada com um parâmetro inválido. Se a função for chamada com um parâmetro inválido, false será retornado.
Observação
Null é um parâmetro válido para esta função. Isso permite que a função seja chamada várias vezes em um script. Por exemplo, se você liberar uma instrução em uma condição de erro e liberá-la novamente no final do script, a segunda chamada para sqlsrv_free_stmt retornará true porque a primeira chamada para sqlsrv_free_stmt (na condição de erro) define o recurso de conexão como null.
Exemplo
O exemplo a seguir cria um recurso de instrução, executa uma consulta simples e chama sqlsrv_free_stmt para liberar todos os recursos associados à instrução. O exemplo supõe que o SQL Server e o banco de dados AdventureWorks estejam instalados no computador local. Toda a saída será gravada no console quando o exemplo for executado da linha de comando.
<?php
/* Connect to the local server using Windows Authentication and
specify the AdventureWorks database as the database in use. */
$serverName = "(local)";
$connectionInfo = array( "Database"=>"AdventureWorks");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false )
{
echo "Could not connect.\n";
die( print_r( sqlsrv_errors(), true));
}
$stmt = sqlsrv_query( $conn, "SELECT * FROM Person.Contact");
if( $stmt )
{
echo "Statement executed.\n";
}
else
{
echo "Query could not be executed.\n";
die( print_r( sqlsrv_errors(), true));
}
/*-------------------------------
Process query results here.
-------------------------------*/
/* Free the statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>
Consulte Também
Referência da API do driver SQLSRV