VLScgSetServerLockMechanism1

Syntax

int VLScgSetServerLockMechanism1 (VLScg_HANDLE iHandle, codeT *codeP, char *criterion, 	
				   int server);

Argument	Description
iHandle	The instance handle for this library.
codeP	The pointer to the codeT struct.
criterion	The locking code criteria to install (in hex).
server	Position in array which is storing the primary locking criteria of the 11 License Managers. Value 0 to "(num_servers) -1" where num_servers is set using VLScgSetNumServers.

Description

Sets the criteria for the primary License Manager.

Installs a License Manager’s primary fingerprint criteria in the code structure. A fingerprint is computed by selecting operating characteristics of the host system and forming a mask with bits set corresponding to those characteristics. The different fingerprinting elements are defined in the VLScg_LOCK_ section of lscgen.h, and includes criteria such as ID Prom, IP address, disk ID, etc.

A License Manager can be locked to either of two groups of fingerprints. The second group is tried if the first fingerprint group fails to match the License Manager’s fingerprint at the end-user site.

Returns

The status code VLScg_SUCCESS is returned if successful. Otherwise, it will return the following error codes:

Error Code	Description
VLScg_INVALID_HEX_TYPE	If criterion is not in hexadecimal format.
VLScg_EXCEEDS_MAX_VALUE	If number of servers exceeds the maximum number of License Managers. The value set using the API VLScgSetNumServers.
VLScg_LESS_THAN_MIN_VALUE	If the number of servers is lower than minimum, which is 5.
VLScg_UNKNOWN_LOCK	Specifies that the locking criteria is unknown.

For the complete list of the error codes, refer to License Generation and Revocation Error Codes .