Método ConfigureModule.ProvideTextData
O método ProvideTextData é chamado por Mergemod.dll para recuperar dados de texto da ferramenta de cliente. Mergemod.dll fornece o Nome da entrada correspondente na tabela ModuleConfiguration.
A ferramenta deve retornar S_OK e fornecer o texto de personalização apropriado em ConfigData. A ferramenta cliente é responsável por alocar os dados, mas Mergemod.dllis é responsável por liberar a memória. Esse argumento DEVE ser um objeto BSTR. LPCWSTR NÃO é aceito.
Se a ferramenta não fornecer dados de configuração para o valor Name, 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.
Qualquer código de retorno diferente de S_OK ou S_FALSE fará com que um erro seja registrado (se um log estiver aberto) e resultará na falha da mesclagem.
Como essa função segue a convenção BSTR padrão, nulo é equivalente à cadeia de caracteres vazia.
Sintaxe
ConfigureModule.ProvideTextData(
Name,
ConfigData
)
Parâmetros
-
Nome
-
Nome do item para o qual os dados estão sendo recuperados.
-
ConfigData
-
Ponteiro para o texto de personalização.
Valor retornado
Esse método não retorna um valor.
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.
C++
Confira Função ProvideTextData.
Requisitos
| Requisito | Valor |
|---|---|
| Versão |
Mergemod.dll 2.0 ou versões posteriores |
| parâmetro |
|
| DLL |
|