sqlsrv_free_stmt

Pobieranie sterownika PHP

Uwalnia wszystkie zasoby związane z określonym zdaniem. Instrukcje nie może być ponownie użyte po wywołaniu tej funkcji.

Syntax

  
sqlsrv_free_stmt( resource $stmt)  

Parametry

$stmt: Oświadczenie zostanie zamknięte.

Wartość zwracana

Wartość boolowska jest prawdziwa, chyba że funkcja jest wywołana nieprawidłowym parametrem. Jeśli funkcja jest wywołana z nieprawidłowym parametrem, zwraca się fałszywe .

Note

Wartość zerowa jest poprawnym parametrem dla tej funkcji. Pozwala to na wielokrotne wywoływanie funkcji w skrypcie. Na przykład, jeśli zwolnisz zdanie w warunku błędu i zwolnisz je ponownie na końcu skryptu, drugie wywołanie sqlsrv_free_stmt zwróci true , ponieważ pierwsze wywołanie sqlsrv_free_stmt (w warunku błędu) ustawia zasób instrukcji na null.

Example

Poniższy przykład tworzy zasób instrukcji, wykonuje proste zapytanie i wywołuje sqlsrv_free_stmt , aby uwolnić wszystkie zasoby związane z danym zakatem. W tym przykładzie przyjęto założenie, że na komputerze lokalnym zainstalowano program SQL Server i bazę danych AdventureWorks . Wszystkie dane wyjściowe są zapisywane w konsoli, gdy przykład jest uruchamiany z wiersza polecenia.

<?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);  
?>