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

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 por Feature. A raiz da árvore de diretório do módulo é redirecionada para o local fornecido por RedirectDir. Para obter mais informações, consulte o método Merge do objeto Merge .

IMsmMerge2::Merge Mergemod.dll versão 2.0 ou posterior.

 

IMsmMerge::Merge Todas as versões Mergemod.dll.

Sintaxe

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

Parâmetros

[in] Feature

O nome de um recurso no banco de dados. Um LPCWSTR pode ser usado no lugar de um BSTR.

[in] RedirectDir

A chave de uma entrada na tabela Directory do banco de dados. Um LPCWSTR pode ser usado no lugar de um BSTR. Esse parâmetro pode ser nulo ou uma cadeia de caracteres vazia.

Valor retornado

A função Merge retorna os valores a seguir.

Valor	Significado
E_FAIL	A mesclagem falhou catastroficamente. Isso indica um erro operacional e não é o retorno de erro normal para uma mesclagem com falha.
S_FALSE	A função foi bem-sucedida, mas houve erros e a mesclagem em si pode não ser válida.
E_INVALIDARG	Um dos argumentos é inválido.
E_OUTOFMEMORY	O sistema ficou sem memória e não pôde concluir a operação.
S_OK	A função foi bem-sucedida.

Comentários

Essa função executa uma mesclagem do banco de dados atual e do módulo atual. A raiz da árvore de diretório do módulo é redirecionada para o local fornecido por RedirectDir. 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 usando a função get_Errors . Erros e mensagens informativas são postados no arquivo de log atual.

Observe que a função Merge obtém todas as referências de recurso no módulo e substitui a referência de recurso para todas as ocorrências do GUID nulo no banco de dados do módulo. Para obter mais informações, confira Referenciando recursos em módulos de mesclagem.

Depois que a mesclagem for concluída, os componentes no módulo serão anexados ao recurso identificado por Feature. Esse recurso já deve existir e não foi criado.

O módulo pode ser anexado a recursos adicionais usando a função Connect . Observe que chamar a função Connect cria apenas associações de componente de recurso. Não modifica as linhas que já foram mescladas no banco de dados.

As alterações feitas no banco de dados não são salvas no disco, a menos que a função CloseDatabase seja chamada com bCommit definido como TRUE.

Requisitos

Cliente mínimo com suporte	Mergemod.dll 1.0 ou versões posteriores
Plataforma de Destino	Windows
Cabeçalho	mergemod.h
DLL	Mergemod.dll

Confira também

Automação de módulo de mesclagem