VLScgSetVendorInfo

Syntax

int VLScgSetVendorInfo (VLScg_HANDLE iHandle, codeT *codeP, char *pcPrivateVendorInfo);
Argument Description

iHandle

The instance handle for this library.

codeP

The pointer to the codeT struct.

pcPrivateVendorInfo

Any printable ASCII text (refer to Reserved Characters and Strings). Maximum of 2000 characters, except in case of redundant licenses, where the vendor information (both public and private) should not exceed 395 characters.

Description

Sets the private vendor information to the value provided in a license. This function also sets the public vendor information to blank.

The private vendor information will remain encrypted in a license code and can be retrieved through a client library function call. You may use it for keeping track of distributors or implementing a variety of licensing schemes.

NOTE   Refer to VLScgAllowVendorInfoExt and VLScgSetVendorInfoExt for setting both the private and public information in a license code. The public information can be read by customers (if the licenses are defined as readable).

Returns

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

Error Code Description

VLScg_INVALID_CHARS

If string is not valid.

VLScg_EXCEEDS_MAX_STRLEN

If value exceeds maximum allowed length of 2000 characters.

VLScg_RESERV_STR_ERR

If the string is a reserved string.

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