detach Method

NOTE This method is deprecated and has been replaced by the Transfer method.

Package: Aladdin

Description

Performs either of the following functions:

>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 in order to use this method.

Syntax

String Aladdin.Hasp.detach ( String detach_action, 
                             String scope, 
                             String vendor_code, 
                             String recipient 
                           )

Parameters

`detach_action`	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>
	Cancel	Cancel operation parameters, in XML format. The following example specifies that the Sentinel SL key with ID “12321” for the detached license should be cancelled: <cancel> <hasp id=”12321”/> </cancel>
`scope`	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 Detach	Definition in XML format of the recipient machine to which the detached license will be attached. Use either the GetInfo or GetSessionInfo method, together with the HASP_RECIPIENT predefined format template, to retrieve the recipient information.
	For Cancel	Ignored (set to Null).
`info`	Reference of the string that receives the output (in XML format). This information is a: >H2R file (for the Detach action), which can then be installed on the recipient machine >R2H file (for the Cancel action), which can then be installed on the host machine The file can be installed using the Update method (or using the Admin Control Center or RUS utility).

Return Values

true/false - indicates success or failure.

Usage Notes

The required Vendor Codes are stored in a VendorCodes folder in your system. Without the correct Vendor Code, the method call cannot succeed.

This method only works with Sentinel SL protection keys; Sentinel HL protection keys are ignored.