Método IMsmConfigureModule::P rovideTextData (mergemod.h)

O método ProvideTextData recupera dados de texto da ferramenta cliente. Para obter mais informações, consulte o método ProvideTextData do objeto ConfigureModule .

Sintaxe

HRESULT ProvideTextData(
  [in]  const BSTR Name,
  [out] BSTR       *ConfigData
);

Parâmetros

[in] Name

Se a ferramenta não fornecer dados de configuração para esse valor, a função deverá retornar S_FALSE. Nesse caso, Mergemod.dll ignora o valor do argumento ConfigData e usa o valor Padrão da tabela ModuleConfiguration.

[out] ConfigData

A ferramenta deve retornar S_OK e fornecer o texto de personalização apropriado em ConfigData. A ferramenta de cliente é responsável por alocar os dados, mas Mergemod.dll é responsável por liberar a memória. Esse argumento deve ser um objeto BSTR . LPCWSTR não é aceito.

Retornar valor

Qualquer código de retorno diferente de S_OK ou S_FALSE faz com que um erro seja registrado (se um log estiver aberto) e resulta na falha da mesclagem.

Comentários

O cliente pode ser chamado apenas uma vez para cada registro na tabela ModuleConfiguration. Observe que Mergemod.dll nunca faz várias chamadas para o cliente com o mesmo valor de "Nome". Se nenhum registro na tabela ModuleSubstitution usar a propriedade, uma entrada na tabela ModuleConfiguration não causará chamadas ao cliente.

Requisitos

Confira também

IMsmConfigureModule

Automação de módulo de mesclagem