(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)
Esta función está OBSOLETA en PHP 7.0.0.
Las alternativas a esta función son:
$stmt
, string $param_name
, mixed &$var
, int $type
[, bool $is_output
= false
[, bool $is_null
= false
[, int $maxlen
= -1
]]] ) : boolVincula un parámetro a un stored procedure MSSQL (local o remoto).
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.
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);
?>