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	Mergemod.h
DLL	Mergemod.dll