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

Syntax

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

Parameters

Name [in]

If the tool does not need to provide any configuration data for this Name value, the function should return S_FALSE. In this case Mergemod.dll ignores the value of the ConfigData argument and will use 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.

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.

Value	Meaning
S_FALSE	The tool does not need to provide configuration data.
S_OK	Function succeeded.

 

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

Version	Mergemod.dll 2.0 or later
Header	Mergemod.h
DLL	Mergemod.dll
IID	IID_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