SdCustomerInformationEx

InstallShield 11 » InstallScript Language Reference

The SdCustomerInformationEx function displays a dialog that allows the end user to enter a name, company name, and serial number, and to indicate 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 all three edit fields. The end user cannot leave any field blank.

The SdCustomerInformationEx function does not verify the serial number. Refer to the InstallShield Tutorial to learn how to add code that verifies the serial number.

Syntax

SdCustomerInformationEx ( szTitle, svName, svCompany, svSerial, 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. SdCustomerInformationEx 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 USERNAME property. 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. SdCustomerInformationEx 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 COMPANYNAME property. 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.

svSerial Returns the serial number entered by the end user. You can use this information and write it to a file or display it in a confirmation dialog. 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_REGISTEREDSERIALNUM.

bvAllUsers

Returns which option the user selected. After SdCustomerInformationEx 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 the "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 MSI installation, if the end user selects the "Anyone who uses this computer [all users]" option button, this function sets the ALLUSERS property to a value of 2.
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.