ConfigureModule.ProvideTextData 方法
Mergemod.dll 调用 ProvideTextData 方法以从客户端工具检索文本数据。 Mergemod.dll 提供 ModuleConfiguration 表中相应条目的 Name。
该工具应返回 S_OK,并在 ConfigData 中提供相应的自定义文本。 客户端工具负责分配数据,但 Mergemod.dll 负责释放内存。 此参数必须是 BSTR 对象。 不接受 LPCWSTR。
如果该工具未提供此 Name 值的任何配置数据,则函数应返回 S_FALSE。 在这种情况下,Mergemod.dll 忽略 ConfigData 参数的值并使用 ModuleConfiguration 表中的 Default 值。
S_OK 或 S_FALSE 以外的任何返回代码都将导致记录错误(如果日志已打开),并将导致合并失败。
由于此函数遵循标准 BSTR 约定,因此 null 等效于空字符串。
语法
ConfigureModule.ProvideTextData(
Name,
ConfigData
)
参数
-
名称
-
要为其检索数据的项的名称。
-
ConfigData
-
指向自定义文本的指针。
返回值
此方法不返回值。
备注
对于 ModuleConfiguration 表中的每个记录,调用客户端的次数不能超过一次。 请注意,Mergemod.dll 永远不会针对同一“Name”值多次调用客户端。 如果 ModuleSubstitution 表中没有记录使用该属性,则 ModuleSubstitution 表中的条目不会导致对客户端的调用。
C++
请参阅 ProvideTextData 函数。
要求
要求 | 值 |
---|---|
版本 |
Mergemod.dll 2.0 或更高版本 |
Header |
|
DLL |
|