ras_ret_query_parms 内核服务

用途

返回ras_query_parms结构中的回调参数。

语法

#include <sys/ras.h>

kerrno_t ras_ret_query_parms (retp, fmtstr, numstrings, descr) ras_query_parms_t *retp; char *fmtstr; int numstrings; char *descr[];

参数

项	描述
雷特普	指向要填写的ras_query_parms_t数据项。
弗姆特斯特尔	这是一个格式说明符。它具有以下格式: `spec-list` 或 `kywd=spec-list kywd=spec-list ...` 其中， spec-list 变量的格式为: 规范，规范， ...。规范变量必须是 %x， %xx ， %d， %dd ， %s或 %ss。如果字符 x ， d 或 s 加倍 (例如， %xx) ，那么这表示允许多个值。以下是一些有效的弗姆特斯特尔值: %x 一个 hexidecimal 值。 %x,%d 一个十六进制值和一个十进制值。 %xx 多个十六进制值。 k1=%x,%d k2=%dd 关键字 k1 采用一个十六进制值和一个十进制值。关键字 k2 采用多个十进制值。
数字字符串	在代斯尔字符串数组中指定字符串的数目。该值必须至少为 1。
代斯尔	指定组件和参数。必须有至少一个字符串。第一个字符串描述组件的函数。如果组件采用位置参数，那么以下字符串将对这些参数进行描述。如果提供了关键字参数，那么每个关键字都必须在描述该关键字的数组中具有对应的代斯尔字符串。如果descr字符串的编号与格式字符串不匹配，ras_ret_query_parms内核服务不会返回错误信息。相反，最后一个关键字没有帮助文本，或者只是显示了多余的帮助字符串。

描述

当回调接收到 RASC_QUERY_PARMS 调用时，"ras_ret_query_parms内核服务可用于帮助填写 "ras_query_parms_t结构。该函数格式化帮助文本，并将其放入ras_query_parms_t结构中。如果所提供的ras_query_parms_t项中的帮助文本空间不足，则返回ENOMEM_RASC_CONTROL_QUERYPARMS。然后，回调仅返回此错误代码。

提供的帮助文本必须遵循以下约定:

component - first line of description
component:parameters - parameter(s) description

或

component - first line of description
component:kywd1=parms - kywd1:parms description
component:kywd2=parms - kywd2:parms description

执行环境

ras_ret_query_parms内核服务只能从进程环境中调用。

返回值

项	描述
重大安全事件数量	指示成功完成。
Einval_ras_control_queryparms	指示有一个或多个参数无效。
故障警报控制查询器	指示一个或多个参数地址是无效的。
enomem_ras_control_queryparms	表示 rqp_text 的大小不够大。