Merge.MergeEx method

El método MergeEx del objeto Merge es equivalente a la función Merge, salvo que toma un argumento adicional. El argumento pConfiguration es una interfaz implementada por el cliente. El argumento puede ser nulo. La presencia de este argumento indica que el cliente es capaz de admitir la funcionalidad de configuración, pero no obliga al cliente a proporcionar datos de configuración para cualquier elemento configurable específico.

El método Merge ejecuta una combinación de la base de datos actual y el módulo actual. La combinación asocia los componentes del módulo a la característica identificada por Feature. La raíz del árbol de directorios del módulo se redirige a la ubicación indicada por RedirectDir.

Sintaxis

Merge.MergeEx(
  Feature,
  RedirectDir,
  pConfiguration
)

Parámetros

Característica

Nombre de una característica de la base de datos.

RedirectDir

Clave de una entrada de la tabla Directory de la base de datos. Este parámetro puede ser null o una cadena vacía.

pConfiguration

El argumento pConfiguration es una interfaz implementada por el cliente. El argumento puede ser nulo. La presencia de este argumento indica que el cliente es capaz de admitir la funcionalidad de configuración, pero no obliga al cliente a proporcionar datos de configuración para cualquier elemento configurable específico.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

Una vez completada la combinación, los componentes del módulo se asocian a la característica que se identifica mediante Feature. Esta característica no se crea, debe ser una característica existente. El módulo se puede asociar a características adicionales mediante el método Connect.

Los cambios realizados en la base de datos solamente se guardan si se llama al método CloseDatabase con bCommit establecido en TRUE.

Si se producen conflictos de combinación, como exclusiones, se colocan en el enumerador de errores para su recuperación posterior, pero no provocan un error de combinación. Los errores pueden recuperarse mediante la propiedad Errors. Los errores y los mensajes informativos se publican en el archivo de registro actual.

Cuando se produce un error en la combinación debido a una configuración de módulo incorrecta, la función MergeEx devuelve E_FAIL. Esto incluye estos errores msmErrorType: msmErrorBadNullSubstitution, msmErrorBadSubstitutionType, msmErrorBadNullResponse, msmErrorMissingConfigItem y msmErrorDataRequestFailed. Estos errores provocan que la combinación se detenga inmediatamente cuando se encuentre el error. El objeto de error todavía se agrega al enumerador cuando MergeEx devuelve E_FAIL. Para más información sobre los errores msmErrorType, consulte get_Type Function (objeto Error)). Todos los demás errores hacen que MergeEx devuelva S_FALSE y que la combinación continúe.

C++

Consulte la función MergeEx.

Requisitos