Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

A custom installer dll should export the Install_Initfunction. 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 TRUEto indicate that this is the first time this function is being called.

fPreviouslyInstalled

[in] Specifies a Boolean value that is set to TRUEto 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