所有回调方法都需要存取配置特性。通过执行以下操作,DSDL 支持对特性的存取:
初始化环境
提供一组公用函数以检索特性值
必须在每个回调方法开始部分进行调用的 scds_initialize 函数可执行以下操作:
检查并处理 RGM 传送到回调方法的命令行参数(argc 和 argv[]),而无需编写命令行分析函数。
设置其他 DSDL 函数使用的内部数据结构。例如,从 RGM 检索特性值的公用函数将在这些结构中存储检索出来的值,同样,在这些数据结构中也将存储命令行值,命令行值优先于从 RGM 检索出来的值。
对于 Validate 方法,scds_initialize 将分析传送到命令行的特性值,而无需编写 Validate 的分析函数。
scds_initialize 函数还将初始化记录环境并验证故障监视器的探测设置。
DSDL 提供了多组函数,以检索资源、资源类型和资源组特性以及常用的扩展特性。通过采用以下约定,这些函数可对特性的存取操作进行标准化。
每个函数仅使用一个句柄参数(由 scds_initialize 返回)。
每个函数都对应一个特定的特性。函数的返回值类型与其检索的特性值的类型相匹配。
因为已预先通过 scds_initialize 计算了这些值,所以函数不会返回错误消息。除非向命令行传递新值,否则函数将从 RGM 检索各个值。