Hasp.Transfer Method

Namespace: Aladdin.Hasp

Description

Transfers a license from a Sentinel SL key.

NOTE This method supersedes the Detach method.

Syntax

static HaspStatus Transfer ( String     action, 
                             String     scope, 
                             String     vendor_code, 
                             String     recipient, 
                             ref String info 
                           )

Parameters

`action`	`Rehost`	Rehost operation parameters, in XML format. The following example specifies that the SL key with Key ID 12321 should be transferred. `<rehost> <hasp id=”12321”/> </rehost>`
	`Detach`	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): `<detach>` `<product id=”12345”>` `<duration>604800</duration>` `</product>` `</detach>`
	`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): `<network_detach>` `<product id=”67876”>` `<duration>31536000</duration>` `<seats>10</seats>` `</product>` `</network_detach>` For more information, see Detaching a License With Concurrency.
	`Cancel_Detach`	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: `<cancel> <hasp id=”12321”/> </cancel>`
`scope`	For `Rehost` or `Cancel_Detach`	Search parameters for the container that is to be rehosted or canceled. For more information, see Scope Input XML Tags.
`scope`	For `Detach`	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
`recipient`	For `Rehost` or `Detach`	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.
`recipient`	For `Cancel_Detach`	Ignored (set to Null).
`info`	Reference of the string that receives the output (in XML format). This information is an: >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).

Return Values

A HaspStatus status code.

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.

Overloaded Method

The following overloaded method is provided. It differs from the method above only in the arguments that it accepts.

static HaspStatus Transfer ( String     action,
                             String     scope,
                             byte[]     vendor_code,
                             String     recipient,
                             ref String info
                            )