Метод IMsmConfigureModule::P rovideTextData (mergemod.h)
Метод ProvideTextData извлекает текстовые данные из клиентского средства. Дополнительные сведения см. в разделе Метод ProvideTextData объекта ConfigureModule .
Синтаксис
HRESULT ProvideTextData(
[in] const BSTR Name,
[out] BSTR *ConfigData
);
Параметры
[in] Name
Если средство не предоставляет данные конфигурации для этого значения, функция должна вернуть S_FALSE. В этом случае Mergemod.dll игнорирует значение аргумента ConfigData и использует значение по умолчанию из таблицы ModuleConfiguration.
[out] ConfigData
Средство должно вернуть S_OK и предоставить соответствующий текст настройки в ConfigData. Клиентское средство отвечает за выделение данных, но Mergemod.dll отвечает за освобождение памяти. Этот аргумент должен быть объектом BSTR . LPCWSTR не принимается.
Возвращаемое значение
Любой код возврата, отличный от S_OK или S_FALSE, вызывает ошибку (если журнал открыт) и приводит к сбою слияния.
Комментарии
Клиент может вызываться не более одного раза для каждой записи в таблице ModuleConfiguration. Обратите внимание, что Mergemod.dll никогда не выполняет несколько вызовов клиента для одного и того же значения name. Если ни одна запись в таблице ModuleSubstitution не использует свойство , запись в таблице ModuleConfiguration не вызывает вызовы к клиенту.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Mergemod.dll 2.0 или более поздней версии |
| Целевая платформа | Windows |
| Header | mergemod.h |
| DLL | Mergemod.dll |