09.12.2012 Views

InstallShield 2012 Spring Express Edition User Guide

InstallShield 2012 Spring Express Edition User Guide

InstallShield 2012 Spring Express Edition User Guide

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

9. Configure the Show All <strong>User</strong>s Option field as appropriate.<br />

Chapter 18: Additional Installation Options<br />

Accessing the Serial Number During and After Installation<br />

When an end user enters a serial number in the Customer Information dialog, it is passed to your .dll file<br />

for verification. If the serial number is successfully verified, the installation can continue. If the serial<br />

number is invalid, the installation will end, depending on how many retries you allow in the Retry Limit<br />

field.<br />

Note: <strong>InstallShield</strong> sequences the serial number .dll file custom action after any user-defined custom actions. Thus, if you<br />

add your own custom action and schedule it after the Customer Information dialog, the installation launches this custom<br />

action before the serial number .dll file custom action.<br />

Accessing the Serial Number During and After<br />

Installation<br />

The Windows Installer property that stores end user’s entry for a serial number is called<br />

ISX_SERIALNUM. If you select Yes for the Show Serial Number setting for the Customer Information<br />

dialog, the serial number field is included on this dialog, and Windows Installer sets the property to the<br />

serial number that the end user enters at run time.<br />

During Installation<br />

During installation, you can access the value of ISX_SERIALNUM by using code such as in this<br />

VBScript sample:<br />

' Get the value of Serial Number<br />

Dim sSerialNo<br />

sSerialNo= Session.Property("ISX_SERIALNUM")<br />

' Show it.<br />

MsgBox sSerialNo<br />

Important: If you want to be able to access the value of ISX_SERIALNUM after the installation, your installation must<br />

store the ISX_SERIALNUM value on the target system somewhere. For example, in the Registry view, you could create a<br />

registry key that adds a value that uses [ISX_SERIALNUM].<br />

After Installation<br />

Following installation, you can access the serial number if your installation wrote the value of the<br />

ISX_SERIALNUM property to the target system. For example, if your installation wrote the value to<br />

the registry, you can write code that checks the registry for the serial number.<br />

<strong>InstallShield</strong> <strong>2012</strong> <strong>Spring</strong> <strong>Express</strong> <strong>Edition</strong> <strong>User</strong> <strong>Guide</strong> ISE-1900-UG00 365

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!