LAPI_Msg_string 子例程

用途

检索与子例程返回码关联的消息。

库

可用性库 (liblapi_r.a)

C 语法

#include <lapi.h>
 
LAPI_Msg_string(error_code, buf)
int error_code;
void *buf;

FORTRAN 语法

include 'lapif.h'
 
LAPI_MSG_STRING(error_code, buf, ierror)
INTEGER error_code
CHARACTER buf(LAPI_MAX_ERR_STRING)
INTEGER ierror

描述

Type of call: 本地查询

使用此子例程来检索与 LAPI 返回码关联的消息字符串。 LAPI 会尝试查找来自AIX®操作系统或其通信子系统的任何返回代码的信息。

参数

INPUT
错误代码: 指定先前 LAPI 调用的返回值。
输出
buf: 指定用于存储消息字符串的缓冲区。
ierror: 指定 FORTRAN 返回码。这始终是最后一个参数。

C 示例

要获取与 LAPI 返回码关联的消息字符串:

{
      
    char msg_buf[LAPI_MAX_ERR_STRING]; /* constant defined in lapi.h */
    int rc, errc; 
          
    rc = some_LAPI_call();
      
    errc = LAPI_Msg_string(rc, msg_buf);
      
    /* msg_buf now contains the message string for the return code   */
      
}

返回值

成功 (LAPI_SUCCESS): 指示函数调用已成功完成。
LAPI_ERR_CATALOG_FAIL: 指示无法打开消息目录。仅英语字符串将复制到用户的消息缓冲区 (buf) 中。
LAPI_ERR_CODE_UNKNOWN: 指示 error_code 超出 LAPI 已知的范围。
LAPI_ERR_RET_PTR_NULL: 指示 buf 指针的值为 NULL (在 C 中) 或 buf 的值为 LAPI_ADDR_NULL (在 FORTRAN 中)。

位置

/usr/lib/liblapi_r.a