PHP Manual
后退 |  | 前进

# db2_conn_errormsg

(no version information, might be only in CVS)

db2_conn_errormsg -- Returns the last connection error message and SQLCODE value

## 说明

string db2_conn_errormsg ( [resource connection] )

警告
本函数是实验性的。本函数的行为，包括函数名称以及其它任何关于本函数的文档可能会在没有通知的情况下随 PHP 以后的发布而改变。使用本函数风险自担。

db2_conn_errormsg() returns an error message and SQLCODE value representing the reason the last database connection attempt failed. As db2_connect() returns `FALSE` in the event of a failed connection attempt, do not pass any parameters to db2_conn_errormsg() to retrieve the associated error message and SQLCODE value.

If, however, the connection was successful but becomes invalid over time, you can pass the connection parameter to retrieve the associated error message and SQLCODE value for a specific connection.

## 参数

connection

  A connection resource associated with a connection that initially succeeded, but which over time became invalid.

## 返回值

Returns a string containing the error message and SQLCODE value resulting from a failed connection attempt. If there is no error associated with the last connection attempt, db2_conn_errormsg() returns an empty string.

## 例

例子 1. Retrieving the error message returned by a failed connection attempt

The following example demonstrates how to return an error message and SQLCODE value after deliberately passing invalid parameters to db2_connect().

`<?php $conn = db2_connect('badname', 'baduser', 'badpassword'); if (!$conn) { print db2_conn_errormsg(); } ?>`

上例将输出：

    Msg:[IBM][CLI Driver] SQL1013N  The database alias name
    or database name "BADNAME" could not be found.  SQLSTATE=42705
     Err Code: -1013

## 参见

db2_conn_error()
db2_connect()
db2_stmt_error()
db2_stmt_errormsg()

后退 | 起点 | 前进
db2_conn_error | 上一级 | db2_connect