Метод 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

См. также раздел

IMsmConfigureModule

Автоматизация модулей слияния