Desktop Engine Windows Installer Callback Functions

Distributing SQL Server with Applications

Distributing SQL Server Applications

Desktop Engine Windows Installer Callback Functions

The Microsoft® SQL Server™ 2000 Desktop Engine Windows Installer functionality supports callback functions that an application setup program can use to tailor its response to the return codes raised by the Desktop Engine Windows Installer.

The setup program developer can code a Desktop Engine callback function as a function in a Microsoft Visual C++® DLL. The callback function is coded the same as a Windows Installer Custom Action Type 1 callback function, except that the Desktop Engine callback function must take an additional UINT parameter that will contain the Desktop Engine exit code, or return code:

UINT __stdcall MyCallbackFunction(MSIHANDLE hinstall, UINT uExitCode)

For more information about coding Windows Installer Custom Action Type 1 DLLs, see the MSDN Library at Microsoft Web site. For a list of the return codes specific to the Desktop Engine, see Desktop Engine Windows Installer Return Codes.

Use the Desktop Engine Windows Installer CALLBACK option to invoke the callback function during setup:

CALLBACK=Dllname!CallbackFunctionName

Specifies the name of the dll containing the Desktop Engine Windows Installer callback function, and the name of the callback function.