cciLogW

记录错误、警告或参考事件。事件由使用指定的自变量作为日志数据的消息代理记录。

语法

void cciLogW(
    int*                returnCode,
    CCI_LOG_TYPE  type,
  const char*       file,
    int                 line,
  const char*       function,
  const CciChar*    messageSource,
    int                 messageNumber,
  const CciChar*      traceText,
                    ...
);

参数

returnCode
来自函数(输出)的返回码。如果参数 messageSource 为 null,则 returnCode 将被设置为 CCI_INV_DATA_POINTER。
type
事件的类型,如 CCI_LOG_TYPE 定义的(输入)。有效值是:
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
调用函数的源文件名(输入)。值是可选的,但对于调试目的非常有用。
line
调用函数的源文件中的行号(输入)。值是可选的,但对于调试目的非常有用。
function
调用日志函数的函数名(输入)。值是可选的,但对于调试目的非常有用。
messageSource
标识 Windows 消息源或 Linux 和 UNIX 消息目录的字符串。
messageNumber
标识事件的消息号码(输入)。如果 messageNumber 指定为零,则假设消息不可用。如果 messageNumber 为非零,则指定的消息写到代理事件 日志中,附带在变量参数列表中提供的任何插入内容(参见下面)。
traceText
写到代理跟踪日志中的跟踪信息(输入)。信息是可选的,但对于调试目的非常有用。
...
包含与消息在一起的任何消息插入内容的 C 变量参数列表(输入)。这些插入内容作为字符串处理,并且变量参数假设为类型指针到 CciChar
注: 该列表中最后的参数必须(CciChar*)0

返回值

无。 如果发生错误,则 returnCode 参数表明错误原因。

示例

void logSomethingWithBroker(CciChar* helpfulText, 
                              char*               file,
                              int                 line,
                            char* func 
                            ){
    int          rc = CCI_SUCCESS;
  /* set up the message catalog name */
  const CciChar* catalog = CciString("BIPv600", BIP_DEF_COMP_CCSID);

  cciLogW(&rc,
          CCI_LOG_INFORMATION          file, line, func,
          catalog, BIP2111,
          helpfulText,  
          helpfulText,  
          (CciChar*)0 
          );     
  
  if(CCI_SUCCESS != rc){
    const CciChar* message = CciString("Failed to log message",
                                       BIP_DEF_COMP_CCSID);
    raiseExceptionWithBroker(message, 
                             __FILE__, 
                             __LINE__, 
                             "logSomethingWithBroker");
  }   
} 
相关概念
用户定义的扩展
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as24570_