VLSgetMachineID

Syntax

LS_STATUS_CODE VLSgetMachineID (unsigned long       lock_selector_in,
                                VLSmachineID        *machineID,
                                unsigned long       *lock_selector_out );

Argument	Description
lock_selector_in	User provided mask specifying locking criteria to be read.
machineID	The “new style“machine ID returned for the applicable lock selectors. The new style machine ID is for version 11 and later licenses.
lock_selector_out	Mask returned specifying for the applicable lock selectors.

Description

Sets the values of the machineID struct for the current host. The input machineID struct should first be initialized by calling VLSinitMachineID. Then, calling this function will attempt to read only those items indicated by the lock_selector_in. If lock_selector_out is not NULL, *lock_selector_out will be set to a bit mask specifying which items were actually read.

To try and obtain all possible machineID struct items, set lock_selector_in to VLS_LOCK_ALL.

VLSgetMachineID allows you to use an Ethernet address as a locking criterion for UNIX computers.

Returns

The status code LS_SUCCESS is returned if successful. For a complete list of the error codes, see Licensing Library Error and Result Codes.