mssql_bind

(PHP 4 >= 4.0.7, PHP 5, PECL odbtp >= 1.1.1)

mssql_bind — Añade un parámetro a un stored procedure (procedimiento almacenado) MSSQL (local o remoto)

Descripción

bool mssql_bind ( resource $stmt , string $param_name , mixed &$var , int $type [, bool $is_output = false [, bool $is_null = false [, int $maxlen = -1 ]]] )

Vincula un parámetro a un stored procedure MSSQL (local o remoto).

Parámetros

stmt

Recurso de solicitud, obtenido con la función mssql_init().

param_name

El nombre del parámetro, como un string.

Nota:

Se ha de incluir el carácter @, como en la sintaxis T-SQL. Ver la explicación incluída en mssql_execute().

var

La variable PHP que se vinculará al parámetro MSSQL. Se pasa por referencia, para obtener los valores OUTPUT y RETVAL una vez el procedimiento ha sido ejecutado.

type

Uno constante de entre: SQLTEXT, SQLVARCHAR, SQLCHAR, SQLINT1, SQLINT2, SQLINT4, SQLBIT, SQLFLT4, SQLFLT8, SQLFLTN.

is_output

Si el valor es un parámetro OUTPUT o no. Si no es un parámetro OUTPUT y no se menciona, éste será tratado como un parámetro de entrada normal y no se generará un error.

is_null

Si el valor es NULL o no. Pasar el valor NULL al parámetro var no hará nada.

maxlen

Utilizado con valores char/varchar. Se ha de indicar la longitud de los datos, por lo que si el parámetro es un varchar(50), el tipo debe ser SQLVARCHAR y su valor 50.

Valores devueltos

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

Ejemplos

Ejemplo #1 Ejemplo con mssql_bind()

<?php
// Conectar a MSSQL y seleccionar la base de datos
mssql_connect('KALLESPC\SQLEXPRESS', 'sa', 'phpfi');
mssql_select_db('php');

// Crear un nuevo stored procedure
$stmt = mssql_init('NewUserRecord');

// Vincular los nombres de campos
mssql_bind($stmt, '@username',  'Kalle',  SQLVARCHAR,  false,  false,  60);
mssql_bind($stmt, '@name',      'Kalle',  SQLVARCHAR,  false,  false,  60);
mssql_bind($stmt, '@age',       19,       SQLINT1,     false,  false,   3);

// Ejecutar
mssql_execute($stmt);

// Liberar los recursos
mssql_free_statement($stmt);
?>

Ver también

  • mssql_execute() - Ejecuta un stored procedure (procedimiento almacenado) en una base de datos del servidor MS SQL
  • mssql_free_statement() - Liberar la memoria ocupada por la sentencia MS SQL
  • mssql_init() - Inicializa un stored procedure (procedimiento almacenado) local o remoto