Método IMsmMerge::Merge (mergemod.h)

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. Para obtener más información, vea el método Merge del objeto Merge .

IMsmMerge2::Merge Mergemod.dll versión 2.0 o posterior.

 
IMsmMerge::Merge Todas las versiones de Mergemod.dll.

Sintaxis

HRESULT Merge(
  [in] const BSTR Feature,
  [in] const BSTR RedirectDir
);

Parámetros

[in] Feature

Nombre de una característica de la base de datos. Se puede usar un LPCWSTR en lugar de un BSTR.

[in] RedirectDir

Clave de una entrada de la tabla Directory de la base de datos. Se puede usar un LPCWSTR en lugar de un BSTR. Este parámetro puede ser null o una cadena vacía.

Valor devuelto

La función Merge devuelve los valores siguientes.

Valor Significado
E_FAIL
Error grave en la combinación. Esto indica un error operativo y no es la devolución de error normal de una combinación con errores.
S_FALSE
La función se realizó correctamente, pero hubo errores y es posible que la propia combinación no sea válida.
E_INVALIDARG
Uno de los argumentos no es válido.
E_OUTOFMEMORY
El sistema se quedó sin memoria y no pudo completar la operación.
S_OK
La función se ha realizado correctamente.

Comentarios

Esta función ejecuta una combinación de la base de datos actual y el módulo actual. La raíz del árbol de directorios del módulo se redirige a la ubicación indicada por RedirectDir. 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 se pueden recuperar mediante la función get_Errors . Los errores y los mensajes informativos se publican en el archivo de registro actual.

Tenga en cuenta que la función Merge obtiene todas las referencias de características en el módulo y sustituye la referencia de características por todas las apariciones del GUID nulo en la base de datos del módulo. Para obtener más información, consulte Hacer referencia a características en módulos de combinación.

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 ya debe existir y no se ha creado.

El módulo se puede asociar a características adicionales mediante la función Connect . Tenga en cuenta que llamar a la función Connect solo crea asociaciones de componentes de características. No se modifican las filas que ya se han combinado en la base de datos.

Los cambios realizados en la base de datos no se guardan en el disco a menos que se llame a la función CloseDatabase con bCommit establecido en TRUE.

Requisitos

   
Cliente mínimo compatible Mergemod.dll 1.0 o posterior
Plataforma de destino Windows
Encabezado mergemod.h
Archivo DLL Mergemod.dll

Consulte también

Automatización de módulos de combinación