An Authorization Definition Parameter Value is the actual numeric value stored inside a definition. This value is a 16-bit unsigned value. 0 to 65535 inclusive.

Although several Authorization Definitions use a parameter (see Authorization Definition Types) the only definition for which you will probably need to directly set or get the parameter value is the General Use Authorization Definition.

You can pre-set a Parameter Value at design-time for General Use Authorization Definitions if you wish. You do not have to pre-activate an Authorization Definition to pre-set a parameter value.

When an Activation Code is successfully activated by the ClientProtector, any parameter value that was embedded in the Activation Code is stored in the definitions parameter value field. If needed, this value can then immediately be inspected by your program by calling the appropriate function on the ClientProtector. This parameter value persists in the license for that definition until it is either:

1. Overwritten by a parameter embedded inside a new Activation Code input and validated for that definition.

2. Programmatically overwritten by the ClientProtector function SetAuthorizationDetails called from your code.

The Manual-Activator ensures that the parameter value embedded inside generated Activation Codes is always within range.

Attempting to programmatically set an Authorization Definition parameter value out of range is undefined.

Attempting to use the Web-Activator to set an Authorization Definition parameter value out range is undefined.

More Information

For help on pre-setting a parameter value for a General Use Authorization Definition, see Setting Authorization Parameter Values in the SoftwareShield License Manager Reference.

For help on embedding parameter values in Activation Codes using the Manual-Activator, see Inputting Parameters in the SoftwareShield Manual-Activator Reference.

For help on embedding parameters in Activation Codes using the Web-Activator, see Web-Interface URL Format in the SoftwareShield Web-Activator Reference.

For help on setting or getting parameter values from the license programmatically see SetAuthorizationDetails and GetAuthorizationDetails in the SoftwareShield ClientProtector Reference.