transfer Supported in On-premises modeSupported in Lease mode

Interface Information

>This API belongs to SentinelLicensing.dll.

>The corresponding library is Sentinel RMS licensing library.

Description

Use this API for:

>Transferring a license authorization from the License Manager. Use the commute (Supported in On-premises mode) action tag for transferring a license authorization from the License Manager.

>Generating the acknowledgment string for returning the commuter authorization code. Use returnCommuter (Supported in On-premises mode Supported in Lease mode) action tag for generating the acknowledgment string.

>Synchronization between the licensed application \ License Manager and SCC. Use the sync (Supported in Lease mode) action for enforcing synchronization.

>Canceling an active lease to SCC so that it is available for other end users to use. Use the cancelLease (Supported in Lease mode) action.

>Resuming the canceled lease and request SCC for a new lease. Use the resumeLease (Supported in Lease mode) action.

>Marking the usage file containing usage data as completed. Use the readyUsageForUpload (Supported in On-premises mode) action.

See Also: Implementing Cancel Lease, Resume Lease, and Force Sync (C, Java, .NET)

Syntax

String transfer(String action)
String transfer(String action,String scope, Attribute attribute, String recipient)

Parameters

Parameter Description
action [in]

Type of transfer action as shown here.

scope [in]

Reserved for future use. Use NULL as the value for this argument.

attribute [in]
recipient [in]

Recipient information of the machine for which the commuter authorization is requested.

Use the recipientInfo query type of the sntl_licensing_get_info API to retrieve the recipient information of the machine for which commuter authorization is required. If this attribute is not used (or NULL is provided as the value for this parameter), the commuter code will be fetched for the local machine.

NOTE   This is applicable to the commute action type only.

Exception Handling

If unsuccessful, throws LicensingException.