Function Reference

The following pages contain a list of PLUS system library functions. They are listed in alphabetical order. Each function definition has the same format. The Applies to designation shows which libraries contain the listed function (i.e. Win32 or Win64). The syntax designation defines the use of each function, both in a 'C' and Visual Basic (VB) syntax.

Most functions have a numeric return value and reference a list of error codes defined in pp_errorstr(). This function contains a table of error numbers and their text description and can be used to convert the number into text during program execution.

It is to your benefit to read the Concepts & Definitions section before attempting to understand the library functions.

 

The following functions are available in the KeyLib library.

 

Function Name

Description

pp_adddays()

Adds or subtracts number of days from a given date

pp_bitclear()

Clears a bit in a bit field

pp_bitset()

Sets a bit in a bit field

pp_bittest()

Determines if a bit is set in a bit field

pp_cenum()

Returns a valid code entry number for trigger screen

pp_checksum()

Determines the checksum of the License File or any other file

pp_compno()

Returns the machine-identifying Computer ID Number

pp_compnoinit()

Initializes and caches the Enhanced Computer ID in memory.

pp_compno32drivers()

Install/Uninstall/Test if a COMP32 driver

pp_convertv3()

Converts Version 3.0 CF / CPF to Version 4.0 LF

pp_copyadd()

Adds the current computer to the list of valid computers

pp_copycheck()

Determines if the current computer is authorized

pp_copycheckth()

Determines if the current computer is authorized using threshold

pp_copydelete()

Removes the current computer from the list of valid computers

pp_copyget()

Gets the computer ID from the given slot, if filled

pp_countdec()

Decrements a number variable stored in License File

pp_countinc()

Increments a number variable stored in License File

pp_daysleft()

Determines number of days before expiration

pp_decrypt()

Decrypts a string given a password

pp_encrypt()

Encrypts a string given a password

pp_errorstr()

Converts a return value error code into a string

pp_expired()

Determines if an application has expired

pp_exportactfile()

Starts the file-based "offline" activation process

pp_eztrial1()

Runs the EZ Trial™ algorithm

pp_eztrial1ex()

Runs the EZ Trial™ algorithm with optional flags

pp_eztrial2()

Runs the EZ Trial 2 algorithm

pp_eztrig1()

Processes EZ Trigger™ algorithm with EZ Trial™

pp_eztrig1ex()

Processes EZ Trigger™ algorithm

pp_eztrig1dlg()

Displays Trigger Code dialog and optionally processes

pp_filedelete()

Unconditionally erases a file

pp_getcode()

Displays generic Trigger Code dialog box and returns Trigger Code number

pp_getcompno()

Retrieves the 32-bit Enhanced Computer ID from memory

pp_getcompnoxml()

Generates an XML string consisting of the hardware related items of the Enhanced Computer ID.

pp_getdate()

Gets the current date from the system clock

pp_getdateex()

Gets the current date from the system clock

pp_gettime()

Gets the current time from the system clock

pp_gettimeex()

Gets the current time from the system clock

pp_getvarchar()

Gets a character-type License File variable

pp_getvardate()

Gets a date-type License File variable

pp_getvarnum()

Gets a numeric-type License File variable

pp_gotourl()

Launches default browser to specific URL

pp_hdserial()

Gets the disk serial number

pp_importactfile()

Completes the file-based "offline" activation process

pp_lanactive()

Determines if License File indicates multiple users are allowed

pp_lancheck()

Determines if workstation count is less than workstation limit

pp_lastday()

Determines the last date of the given month

pp_lfalias()

Creates a redundant alias to an open License File

pp_lfclose()

Closes the License File

pp_lfcopy()

Copies a License File to another location

pp_lfcreate()

Creates a file with the requested attributes

pp_lfdelete()

Removes a License File from the Registry

pp_lflock()

Locks the License File from other users

pp_lfopen()

Opens the License File and returns a handle

pp_lfunlock()

Unlocks the License File

pp_libtest()

Determines if the valid PLUS system library has been altered or replaced

pp_ndecrypt()

Decrypts a number given a seed number

pp_ndecryptx()

Decrypts four numbers from string given a seed number

pp_nencrypt()

Encrypts a number given a seed number

pp_nencryptx()

Encrypts four numbers into string given a seed number

pp_netclose()

Closes the handle passed in for the Network Broadcast algorithm.

pp_netopen()

Opens a handle for the Network Broadcast algorithm.

pp_nettest()

Tests the validity of a handle for the Network Broadcast algorithm.

pp_npdate()

Determines payment expiration date of next month

pp_password()

Encrypts a string that cannot be decrypted

pp_redir()

Determines if given drive letter is a redirected (network) drive

pp_semclose()

Closes the Network Semaphore File

pp_semcount()

Counts the number of available workstation licenses

pp_semopen()

Opens the Network Semaphore File in exclusive mode

pp_semtest()

Verifies the Network Semaphore File is still open

pp_semused()

Counts the number of used workstation licenses

pp_setvarchar()

Sets a character-type License File variable

pp_setvardate()

Sets a date-type License File variable

pp_setvarnum()

Sets a numeric-type License File variable

pp_sysinfo()

Tests if system is running in a specific environment.

pp_tcode()

Decode which Trigger Code number was entered

pp_timercheck()

Determines if application timer has expired

pp_timerstart()

Starts application timer to expire in given number of minutes

pp_transfer()

Assists in transferring license from one machine to another

pp_upddate()

Updates the last date and time used fields in License File

pp_valdate()

Verifies current date / time > last used date / time fields