(No version information available, might only be in Git)
sqlsrv_free_stmt — Libera todos os recursos para a declaração especificada
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.
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.
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));
}
sqlsrv_free_stmt( $stmt);
?>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.