sqlsrv_free_stmt
指定されたステートメントに関連付けられているリソースがすべて解放されます。この関数が呼び出された後にステートメントを再度使用することはできません。
構文
sqlsrv_free_stmt( resource $stmt)
パラメータ
$stmt: 終了するステートメント。
戻り値
関数の呼び出しで無効なパラメータが使用されていない場合はブール値 true、関数の呼び出しで無効なパラメータが使用されている場合は false が返されます。
注意
この関数では、Null は有効なパラメータです。そのため、この関数はスクリプトで複数回呼び出すことができます。たとえば、エラー発生時にステートメントを解放し、スクリプトの末尾で再度解放する場合、sqlsrv_free_stmt の最初 (エラー発生時) の呼び出しでステートメント リソースが null に設定されるため、sqlsrv_free_stmt の 2 回目の呼び出しでは true が返されます。
例
次の例では、ステートメント リソースを作成し、簡単なクエリを実行した後、sqlsrv_free_stmt を呼び出してステートメントに関連付けられたすべてのリソースを解放します。この例では、SQL Server と AdventureWorks データベースがローカル コンピュータにインストールされていることを前提としています。この例をコマンド ラインから実行した場合、すべての出力はコンソールに書き込まれます。
<?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);
?>