IMsmConfigureModule::ProvideTextData Method

Windows Installer

IMsmConfigureModule::ProvideTextData Method

The ProvideTextData method retrieves text data from the client tool. For more information, see the ProvideTextData method of the ConfigureModule object.

Syntax

C++HRESULT ProvideTextData(
  [in]   BSTR Name,
  [out]  BSTR *ConfigData
);

Parameters

Name [in]

If the tool does not provide any configuration data for this value, the function should return S_FALSE. In this case, Mergemod.dll ignores the value of the ConfigData argument and uses the Default value from the ModuleConfiguration table.

ConfigData [out]

The tool should return S_OK and provide the appropriate customization text in ConfigData. The client tool is responsible for allocating the data, but Mergemod.dll is responsible for releasing the memory. This argument must be a BSTR object. LPCWSTR is not accepted.

Return Value

Any return code other than S_OK or S_FALSE causes an error to be logged (if a log is open) and results in the merge failing.

S_FALSE
S_OK

Remarks

The client may be called no more than once for each record in the ModuleConfiguration table. Note that Mergemod.dll never makes multiple calls to the client for the same "Name" value. If no record in the ModuleSubstitution table uses the property, an entry in the ModuleConfiguration table causes no calls to the client.

Requirements

VersionMergemod.dll 2.0 or later
HeaderMergemod.h
DLLMergemod.dll
IIDIID_IMsmConfigureModule is defined as AC013209-18A7-4851-8A21-2353443D70A0

See Also

Merge Module Automation

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.