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.
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 |
|---|---|
|
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. |
|
La función se realizó correctamente, pero hubo errores y es posible que la propia combinación no sea válida. |
|
Uno de los argumentos no es válido. |
|
El sistema se quedó sin memoria y no pudo completar la operación. |
|
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 |