Метод 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 или более поздней версии |
| Заголовок |
|
| DLL |
|