VLSinstallCommuterCode

Installs a commuter authorization onto a remote computer. A computer that has network access to the License Manager should generate the commuter authorization using VLSgetCommuterCode. The commuter authorization is then passed on to the computer requiring the authorization and installed using VLSinstallCommuterCode. After successful completion of this call, the remote computer should be able to use the commuter authorization.

If the machine that requires the commuter authorization has network access to the License Manager, then you do not need to use this call. Instead, check out the commuter authorization using VLSgetAndInstallCommuterCode, VLSgetAndInstallCommuterCodeExt API. Once a commuter authorization is checked out for a remote computer, it cannot be checked back in—it simply expires.

Syntax

LS_STATUS_CODE VLSinstallCommuterCode (	 	 
unsigned char	 	*commuter_code,
unsigned char	 	*reserved1,
unsigned long	 	*reserved2 );

Argument	Description
commuter_code	The commuter authorization that was generated by a computer with network access to the License Manager.
reserved1	Reserved. Use NULL for this value.
reserved2	Reserved. Use NULL for this value.

Returns

The status code LS_SUCCESS is returned if successful. Otherwise, a specific error code is returned indicating the reason for the failure. Possible errors that can be returned by this call include VLS_UNABLE_TO_INSTALL_COMMUTER_CODE.

For a complete list of error codes, see Licensing Library Error and Result Codes.