Método Merge.MergeEx

O método MergeEx do objeto Merge é equivalente à função Merge, com a exceção de que ele usa um argumento extra. O argumento pConfiguration é uma interface implementada pelo cliente. O argumento poderá ser nulo. A presença desse argumento indica que o cliente tem a capacidade de dar suporte à funcionalidade de configuração, mas não obriga o cliente a fornecer dados de configuração para nenhum item configurável específico.

O método Merge executa uma mesclagem do banco de dados atual e do módulo atual. A mesclagem anexa os componentes no módulo ao recurso identificado pelo Recurso. A raiz da árvore de diretório do módulo é redirecionada para o local fornecido pelo RedirectDir.

Sintaxe

Merge.MergeEx(
  Feature,
  RedirectDir,
  pConfiguration
)

Parâmetros

Recurso

O nome de um recurso no banco de dados.

RedirectDir

A chave de uma entrada na tabela Directory do banco de dados. Esse parâmetro pode ser nulo ou uma cadeia de caracteres vazia.

pConfiguration

O argumento pConfiguration é uma interface implementada pelo cliente. O argumento poderá ser nulo. A presença desse argumento indica que o cliente tem a capacidade de dar suporte à funcionalidade de configuração, mas não obriga o cliente a fornecer dados de configuração para nenhum item configurável específico.

Valor retornado

Esse método não retorna um valor.

Comentários

Depois que a mesclagem for concluída, os componentes no módulo serão anexados ao recurso identificado por Feature. Esse recurso não é criado e precisa ser um recurso existente. O módulo pode ser anexado a recursos adicionais por meio do método Connect.

As alterações feitas no banco de dados serão salvas se e somente se o método CloseDatabase for chamado com bCommit definido como TRUE.

Se ocorrerem conflitos de mesclagem, incluindo exclusões, eles serão colocados no enumerador de erro para recuperação posterior, mas não causarão nenhuma falha na mesclagem. Erros podem ser recuperados por meio da propriedade Errors. Os erros e as mensagens informativas são postados no arquivo de log atual.

Quando ocorre uma falha na mesclagem devido a uma configuração de módulo incorreta, a função MergeEx retorna E_FAIL. Isso inclui estes erros msmErrorType: msmErrorBadNullSubstitution, msmErrorBadSubstitutionType, msmErrorBadNullResponse, msmErrorMissingConfigItem e msmErrorDataRequestFailed. Esses erros fazem com que a mesclagem seja imediatamente interrompida quando o erro é encontrado. O objeto de erro ainda é adicionado ao enumerador quando MergeEx retorna E_FAIL. Para obter mais informações sobre os erros msmErrorType, confira Função get_Type (objeto Error). Todos os outros erros fazem com que MergeEx retorne S_FALSE e com que a mesclagem continue.

C++

Confira a função MergeEx.

Requisitos

Requisito	Valor
Versão	Mergemod.dll 2.0 ou versões posteriores
parâmetro	Mergemod.h
DLL	Mergemod.dll