SdCustomerInformation

InstallShield 11 » InstallScript Language Reference

The SdCustomerInformation function displays a dialog that allows the end user to enter a name and company name, and to specify whether the installed application should be available for only the current user or for all users of the target machine.

The Next button becomes enabled only when data exists in both edit fields. The end user cannot leave any field blank.

Syntax

SdCustomerInformation ( szTitle, svName, svCompany, bvAllUsers );

Parameters

Parameter Description

szTitle Specifies the title of the dialog box. To display the default title (“Customer Information”), pass a null string ("") in this parameter.

svName Returns the name entered by the user. SdCustomerInformation displays the initial value of this parameter for editing by the user. If both svName and svCompany are null strings, the user name found in the target system's registry is displayed for editing. In an InstallScript MSI installation, the information that the end user enters in this field is used to set the value of the Windows Installer property USERNAME. In an InstallScript installation, the information that the end user enters in this field is used to set the value of the system variable IFX_PRODUCT_REGISTEREDOWNER.

svCompany Returns the company name entered by the user. SdCustomerInformation displays the initial value of this parameter for editing by the user. If both svName and svCompany are null strings, the company name found in the target system's registry is displayed for editing. In an InstallScript MSI installation, the information that the end user enters in this field is used to set the value of the Windows Installer property COMPANYNAME. In an InstallScript installation, the information that the end user enters in this field is used to set the value of the system variable IFX_PRODUCT_REGISTEREDCOMPANY.

bvAllUsers

Returns which option the user selected. After SdCustomerInformation returns, bvAllUsers will be set to one of the following values:

TRUE	“Anyone who uses this computer [all users]” option is selected by default.
FALSE	“Only for me [user name]” option is selected by default.

The default radio button selection is based not based on the current value of the bvAllUsers parameter, but on the ALLUSERS Windows Installer property in an InstallScript MSI installation, or on the ALLUSERS system variable in an InstallScript installation. If the ALLUSERS property is 2 or the ALLUSERS system variable is non-zero, the "Anyone who uses this computer [all users]" option button is selected by default. If the ALLUSERS property is 1 or the ALLUSERS system variable is FALSE, the "Only for me [<user name>]" option button is selected by default.

Return Values

Return Value	Description
NEXT (1)	Indicates that the Next button was clicked.
BACK (12)	Indicates that the Back button was clicked.

Additional Information

To view an example of this or other dialog boxes for your installation, use the Dialog Sampler in InstallShield. In InstallShield, on the Tools menu, point to InstallScript, then click Standard Dialog Sampler or Skinned Dialog Sampler.
In an InstallScript MSI installation, when the end user clicks Next the USERNAME and COMPANYNAME properties are set using the information contained in the svName and svCompany fields, respectively.
In an InstallScript installation, this function does not set the value of the system variable TARGETDIR. To change the value of TARGETDIR based on the end user's input in the dialog box, use code like the following (from the default OnFirstUIBefore event handler code) after calling this function:
```
if ( ALLUSERS ) then
    TARGETDIR = PROGRAMFILES ^ IFX_COMPANY_NAME ^ IFX_PRODUCT_NAME;
else
    TARGETDIR = FOLDER_APPDATA ^ IFX_COMPANY_NAME ^ IFX_PRODUCT_NAME;
endif;
```
In an InstallScript installation, if the end user selects "Anyone who uses this computer [all users]" option button, this function sets the system variable ALLUSERS to a non-zero value. If the end user selects the "Only for me [<user name>]" option button, this function sets ALLUSERS to FALSE.
In an InstallScript installation, if the system variable DISABLE_ALLUSERBTN is non-zero the "Anyone who uses this computer [all users]" option button is disabled. If the system variable DISABLE_PERUSERBTN is non-zero, the "Only for me [<user name>]" option button is disabled.
The "Anyone who uses this computer [all users]" option button is enabled only if the target system is Windows 2000, XP, or later and the user is an administrator or power user.