Install_Init

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

A custom installer dll should export the Install_Init function. This function will be called before installation begins. This function can be used for custom operations such as checking an application version for application re-installation or determining whether a dependent application is present. For more information, see Optional Setup.dll Files for Installation.

Syntax

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

Parameters

  • hwndParent
    [in] Specifies a handle to the parent window.
  • fFirstCall
    [in] Specifies a Boolean value that is set to TRUE to indicate that this is the first time this function is being called.
  • fPreviouslyInstalled
    [in] Specifies a Boolean value that is set to TRUE to indicate that the current application is already installed.
  • pszInstallDir
    [in] Reference to a null-terminated string that contains the name of the application installation directory that is selected by the user.

Return Value

  • codeINSTALL_INIT_CONTINUE
    Continue installation.
  • codeINSTALL_INIT_CANCEL
    Cancel installation.

Remarks

This function may be called multiple times, each time with a different string for pszInstallDir. For example, when the current directory does not have enough room, you should call this function for the first time. .

This function is called during installation once the installation process has been completed.

Requirements

Header ce_setup.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

codeINSTALL_INIT
File and Application Management Functions
Install_Exit