Install_Init (Windows CE 5.0)

Send Feedback

This function is called before installation begins. It is used for operations such as checking the version of an application during reinstallation or seeing whether a dependent application is present.

Install_Init is developer-written, using the specified prototype for compatibility.

codeINSTALL_INITInstall_Init(HWNDhwndParent,BOOLfFirstCall,BOOLfPreviouslyInstalled,LPCTSTRpszInstallDir);

Parameters

  • hwndParent
    [in] Handle to the parent window.
  • fFirstCall
    [in] When set TRUE, indicates this is the first time this function is being called.
  • fPreviouslyInstalled
    [in] When set TRUE, indicates the current application is already installed.
  • pszInstallDir
    [in] Pointer to null-terminated string with the name of the user-selected installation directory.

Return Values

Value Description
codeINSTALL_INIT_CONTINUE Continue installation.
codeINSTALL_INIT_CANCEL Cancel installation.

Remarks

Install_Init can be called multiple times with different strings 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.

The Install_Init function is part of the application's setup and uninstall program, Setup.dll.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Ce_setup.h.
Link Library: Developer-provided.

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.