(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)
$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).
stmtRecurso de solicitud, obtenido con la función mssql_init().
param_nameEl 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().
varLa 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_outputSi 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.
Devuelve TRUE en caso de éxito o FALSE en caso de error.
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);
?>