Partilhar via


sqlsrv_free_stmt

Baixar driver PHP

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

Sobre exemplos de código na documentação

sqlsrv_cancel