transfer Method
Package: Aladdin
Description
Transfers a license from a Sentinel SL key.
NOTE This method supersedes the Detach method.
Syntax
String Aladdin.Hasp.transfer ( String action,
String scope,
String vendor_code,
String recipient
)
Parameters
action
|
|
Rehost operation parameters, in XML format. The following example specifies that the SL key with Key ID 12321 should be transferred.
|
|
|
Detach operation parameters, in XML format. The following example specifies that a detached license for Product ID 12345 will expire after 604,800 seconds (one week):
|
|
Network_Detach
|
Detach a license with concurrency operation parameters, in XML format. The following example specifies that a license with 10 concurrent seats for Product ID 67876 will expire after 31,536,000 seconds (one year):
For more information, see Detaching a License With Concurrency. |
|
|
|
Cancel detach or network_detach operation parameters, in XML format. The following example specifies that the Sentinel SL key with Key ID “12321” for the detached license should be cancelled:
|
|
|
|
For |
Search parameters for the container that is to be rehosted or canceled. For more information, see Scope Input XML Tags. |
|
For |
Search parameters for the Product that is to be detached. For more information, see Scope Input XML Tags. |
|
vendor_code
|
Bytes that contain the Vendor Code |
|
|
|
For
|
Definition in XML format of the recipient machine to which the transferred or detached license or seats will be attached. Use either the GetInfo or GetSessionInfo method, together with the HASP_RECIPIENT predefined format template, to retrieve the recipient information. |
|
For
|
Ignored (set to Null). |
|
|
|
>H2H file (for the Rehost action) >H2R file (for the Detach action) >R2H file (for the Cancel_Detach action). If the detached Product is already expired, no buffer is returned. To complete the operation, the file should be installed on the target machine using the Update method (or using the Admin Control Center or RUS utility). |
|
Usage Notes
Performs one of the following functions:
>Removes a Sentinel SL key from its host machine and prepares it to be transferred ("rehosted") to a target machine. The protection key must be defined with rehosting allowed.
>Detaches a license for a Product from a Sentinel SL key (on the host machine), according to customizable parameters. Features defined as detachable and memory files that belong to the Product are detached.
>Cancels a detached license from the Sentinel SL key (on the recipient machine), typically before the detached license was due to expire.
You do not need to be logged in to a Feature or Sentinel protection key in order to use this method.
The required Vendor Codes are stored in a VendorCodes folder in your system. Without the correct Vendor Code, the method call cannot succeed.