sqlsrv_cancel

(No version information available, might only be in Git)

sqlsrv_cancelCancela una sentencia de base de datos

Descripción

sqlsrv_cancel ( resource $stmt ) : bool

Cancela una sentencia de base de datos. Cualquier resultado asociado con la sentencia que no haya sido utilizado será eliminado. Después de llamar a sqlsrv_cancel() , la sentencia especificada puede ser reejecutada si fue creada con sqlsrv_prepare(). No es necesario llamar a sqlsrv_cancel() si todos los resultados asociados se han utilizado.

Parámetros

stmt

El recurso de la sentencia que se va a cancelar.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de sqlsrv_cancel()

<?php
$serverName 
"serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName""UID"=>"username""PWD"=>"password");
$conn sqlsrv_connect$serverName$connectionInfo);
if( 
$conn === false ) {
     die( 
print_rsqlsrv_errors(), true));
}

$sql "SELECT Sales FROM Table_1";

$stmt sqlsrv_prepare$conn$sql);

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

if( 
sqlsrv_execute$stmt ) === false) {
     die( 
print_rsqlsrv_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 />";

// Cancela los resultados pendientes. La sentencia se puede reutilizar.
sqlsrv_cancel$stmt);
?>

Notas

La principal diferencia entre sqlsrv_cancel() y sqlsrv_free_stmt() es que una sentencia cancelada con sqlsrv_cancel() puede ser reejecutada si fue creada con sqlsrv_prepare(). Una sentencia cancelada con sqlsrv_free_statement() no puede ser reejecutada.

Ver también