VLScgSetClientLockMechanism

Syntax 

int VLScgSetClientLockMechanism (VLScg_HANDLE iHandle, codeT *codeP, char *criterion, 
			           int client_num);

Argument	Description
iHandle	The instance handle for this library.
codeP	The pointer to the codeT struct.
criterion	Mask defining which fields of machineID are to be used for locking. Value should be in hex format.
client_num	client_num is the position in the array storing the locking mechanisms for the clients. The value will vary from 0 to num_nl_clients - 1, where num_nl_clients is the number of clients set using VLScgSetNumClients.

Description

Installs a client’s 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.

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 client_num exceeds num_nl_clients - 1. The value set using the API VLScgSetNumClients.
VLScg_LESS_THAN_MIN_VALUE	If the client_num is less than 0.
VLScg_UNKNOWN_LOCK	if the locking criterion is unknown.

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