精通
英语
和
开源
,
擅长
开发
与
培训
,
胸怀四海
第一信赖
qtssModuleObject类型的对象是由一些描述QTSS模块的属性组成,包括模块的名称,版本号,模块功能描述,模块的偏好设定,以及模块注册了什么角色。模块对象(QTSS_ModuleObject)就是这种对象类型的实例。这些属性对于所有从服务器传入的结构中取得QTSS_ModuleObject对象的角色来说都是正当的。
服务器会为每个装载的模块创建一个模块对象,并将它传递给模块的Initialize角色。模块可以通过访问QTSS_ServerObject对象中的qtssSvrModuleObject属性来获得其它模块的信息。
除了存储模块名称,版本名称及描述的属性以外,这个对象类型还有一个模块预置属性,即qtssModPrefs。qtssModPrefs属性本身也是一个对象,模块的预置信息作为该对象的实例属性进行保存。所有对于qtssModPrefs属性的修改在不同的服务器实例之间都是可持续的,因为每个模块的qtssModPrefs属性内容都被写入到服务器的配置文件中,而服务器每次启动都读取这个文件。
表1-6列举了类型为qtssModuleObjectType的对象的属性。
请注意:除了qtssModDesc和qtssModVersion两个例外,所有这些属性对于抢占访问都是安全的,因此您可以调用QTSS_GetValue,QTSS_GetValueAsString,和QTSS_GetValuePtr函数来读取这些属性的值。
属性名称及其描述 | 访问 | 数据类型 |
---|---|---|
qtssModName 模块名称。 | 可读,抢占访问安全 | char |
qtssModDesc 模块功能描述。 | 可读,写操作不是抢占访问安全 | char |
qtssModVersion 模块的版本号,格式为0xMM.m.v.bbbb,其中MM = 大版本, m = 小版本,v = 非常小的版本 b = 连编(build)号。 | 可读,可写,不是抢占访问安全 | UInt32 |
qtssModRoles 当前模块注册的所有角色的列表。 | 可读,抢占访问安全 | QTSS_Role |
qtssModPrefs 这是一个对象,其属性存储当前模块的预置信息。 | 可读,抢占访问安全 | QTSS_ModulePrefsObject |
qtssModAttributes 这是一个对象,模块可以用这个对象来存储除了预置信息之外的本地属性。 | 可读,可写,抢占访问安全 | QTSS_Object |