Install_Init

The Install_Init function prototype is called before installation begins. This function can be used for custom operations such as checking an application version in a reinstall scenario or checking if a dependent application is present.

Syntax

codeINSTALL_INIT Install_Init(HWND hwndParent,BOOL fFirstCall, BOOL fPreviouslyInstalled, LPCTSTR pszInstallDir);

Parameters

hwndParent

Handle to the parent window.

fFirstCall

TRUE — This is the first time this function is being called.

Note: Install_Init may be called multiple times, each time with a different string for pszInstallDir; for example, when the current directory does not have enough room. ISVs should do "first time" processing when fFirstCall is TRUE and be aware that subsequent calls to Install_Init may result in different string values for pszInstallDir.

fPreviouslyInstalled

TRUE — The current application is already installed.

pszInstallDir

The user-selected install directory of the application.

Return Values

• codeINSTALL_INIT_CONTINUE //continue installation
• codeINSTALL_INIT_CANCEL //cancel installation

Remarks

The Install_Init function prototype is part of Setup.dll, an ISV-created file for custom operations dealing with installation and uninstallation of applications.