Merge.MergeEx 方法

Merge 对象的 MergeEx 方法等效于 Merge 函数，只不过它需要额外的参数。 pConfiguration 参数是由客户端实现的接口。 该自变量可能为 null。 存在此参数表明客户端能够支持配置功能，但不强制客户端为任何特定的可配置项提供配置数据。

Merge 方法可执行当前数据库和当前模块的合并。 合并将模块中的组件附加到 Feature 标识的功能。 模块目录树的根将被重定向到 RedirectDir 提供的位置。

语法

Merge.MergeEx(
  Feature,
  RedirectDir,
  pConfiguration
)

参数

功能

数据库中功能的名称。

RedirectDir

数据库的 Directory 表中条目的键。 此参数不能为 NULL 或空字符串。

pConfiguration

pConfiguration 参数是由客户端实现的接口。 该自变量可能为 null。 存在此参数表明客户端能够支持配置功能，但不强制客户端为任何特定的可配置项提供配置数据。

返回值

此方法不返回值。

备注

合并完成后，模块中的组件将附加到 Feature 标识的功能。 此功能未创建，并且必须是现有功能。 可以使用 Connect 方法将模块附加到其他功能。

除非在将 bCommit 设置为 TRUE 的情况下调用 CloseDatabase 方法，否则不会保存对数据库所做的更改。

如果发生任何合并冲突（包括排除项），它们将放在错误枚举器中供以后检索，但不会导致合并失败。 可通过 Errors 属性来检索错误。 错误和信息性消息发布到当前日志文件。

当合并因模块配置不正确而失败时，MergeEx 函数将返回E_FAIL。 这包括以下 msmErrorType 错误：msmErrorBadNullSubstitution、msmErrorBadSubstitutionType、msmErrorBadNullResponse、msmErrorMissingConfigItem 和 msmErrorDataRequestFailed。 这些错误会导致在遇到错误时立即停止合并。 当 MergeEx 返回 E_FAIL 时，错误对象仍添加到枚举器中。 有关 msmErrorType 错误的详细信息，请参阅 get_Type 函数（错误对象）。 所有其他错误都会导致 MergeEx 返回 S_FALSE 并导致合并继续。

C++

请参阅 MergeEx 函数。

要求

要求	值
版本	Mergemod.dll 2.0 或更高版本
Header	Mergemod.h
DLL	Mergemod.dll