Método IMsmMerge2::MergeEx (mergemod.h)

O método MergeEx 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 MergeEx do objeto Merge .

Sintaxe

HRESULT MergeEx(
  [in] const BSTR Feature,
  [in] const BSTR RedirectDir,
  [in] IUnknown   *pConfiguration
);

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 NULL ou uma cadeia de caracteres vazia.

[in] pConfiguration

O argumento pConfiguration é uma interface implementada pelo cliente. O argumento pode ser NULL. A presença desse argumento indica que a ferramenta cliente é capaz de modificar módulos de mesclagem configuráveis. A presença desse argumento não exige que o cliente forneça dados de configuração para qualquer item configurável específico.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Significado
E_OUTOFMEMORY	O sistema ficou sem memória e não pôde concluir a operação.
E_INVALIDARG	Um dos argumentos é inválido.
E_FAIL	A mesclagem foi interrompida devido a um erro. Algumas tabelas podem não ter sido mescladas. Consulte a seção Comentários para obter mais informações.
S_FALSE	A função foi bem-sucedida, mas houve erros e a mesclagem em si pode não ser válida.
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 get_Errors função. Erros e mensagens informativas serão postados no arquivo de log atual.

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 .

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

Quando a mesclagem falha devido a uma configuração de módulo incorreta, a função 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.

Requisitos

Cliente mínimo com suporte	Mergemod.dll 2.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