sqlsrv_cancel

(사용 가능한 버전 정보가 없으며 Git에만 있을 수 있음)

sqlsrv_cancel — 명령문 취소

sqlsrv_cancel(resource $stmt): bool

명령문을 취소합니다. 사용되지 않은 명령문과 관련된 모든 결과는 삭제됩니다. sqlsrv_cancel()이 호출된 후 지정된 명령문이 sqlsrv_prepare()로 생성된 경우 다시 실행할 수 있습니다. 명령문과 연관된 모든 결과가 사용된 경우 sqlsrv_cancel()을 호출할 필요가 없습니다.


매개변수

stmt
취소할 명령문 리소스입니다.

반환 값

성공하면 true를, 실패하면 false를 반환합니다.


Examples

예제 #1 sqlsrv_cancel() 예제

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

$sql = "SELECT Sales FROM Table_1";

$stmt = sqlsrv_prepare( $conn, $sql);

if( $stmt === false ) {
     die( print_r( sqlsrv_errors(), true));
}

if( sqlsrv_execute( $stmt ) === false) {
     die( print_r( sqlsrv_errors(), true));
}

$salesTotal = 0;
$count = 0;

while( ($row = sqlsrv_fetch_array( $stmt)) && $salesTotal <=100000)
{
     $qty = $row[0];
     $price = $row[1];
     $salesTotal += ( $price * $qty);
     $count++;
}

echo "$count sales accounted for the first $$salesTotal in revenue.<br />";

// Cancel the pending results. The statement can be reused.
sqlsrv_cancel( $stmt);
?>
                  
                

메모

sqlsrv_cancel()sqlsrv_free_stmt()의 주요 차이점은 sqlsrv_cancel()로 취소된 명령문 리소스가 sqlsrv_prepare()로 생성된 경우 다시 실행할 수 있다는 것입니다. sqlsrv_free_statement()로 취소된 명령문 리소스는 다시 실행할 수 없습니다.


기타