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