Метод ConfigureModule.ProvideTextData

Метод ProvideTextData вызывается Mergemod.dll для получения текстовых данных из клиентского средства. Mergemod.dll предоставляет имя из соответствующей записи в таблице ModuleConfiguration.

Средство должно вернуть S_OK и предоставить соответствующий текст настройки в ConfigData. Клиентское средство отвечает за выделение данных, а Mergemod.dll — за освобождение памяти. Этот аргумент ДОЛЖЕН быть объектом BSTR . LPCWSTR НЕ принимается.

Если средство не предоставляет данные конфигурации для этого значения Name , функция должна возвращать S_FALSE. В этом случае Mergemod.dll игнорирует значение аргумента ConfigData и использует значение по умолчанию из таблицы ModuleConfiguration.

Любой код возврата, отличный от S_OK или S_FALSE, приведет к регистрации ошибки (если журнал открыт) и приведет к сбою слияния.

Так как эта функция соответствует стандартному соглашению BSTR , значение NULL эквивалентно пустой строке.

Синтаксис

ConfigureModule.ProvideTextData(
  Name,
  ConfigData
)

Параметры

имя;

Имя элемента, для которого извлекаются данные.

ConfigData

Указатель на текст настройки.

Возвращаемое значение

Этот метод не возвращает значение.

Комментарии

Клиент может вызываться не более одного раза для каждой записи в таблице ModuleConfiguration. Обратите внимание, что Mergemod.dll никогда не выполняет несколько вызовов клиента для одного и того же значения "Имя". Если ни одна запись в таблице ModuleSubstitution не использует свойство , запись в таблице ModuleConfiguration не вызывает вызовы к клиенту.

C++

См . раздел Функция ProvideTextData.

Требования

Требование	Значение
Версия	Mergemod.dll 2.0 или более поздней версии
Заголовок	Mergemod.h
DLL	Mergemod.dll