Update Function

Description

Write an update to a local or remote Sentinel protection key.

Syntax

hasp_status_t HASP_CALLCONV hasp_update (
                const char * update_data,
               char ** ack_data
                )

Parameters

update_data

Update data

ack_data

Pointer to a buffer to retrieve the acknowledgment data.

Return Values

HASP_STATUS_OK

HASP_OLD_LM

HASP_INV_UPDATE_DATA

HASP_NO_ACK_SPACE

HASP_KEYID_NOT_FOUND

HASP_INV_UPDATE_NOTSUPP

HASP_INSUF_MEM

HASP_UNKNOWN_ALG

HASP_INV_UPDATE_CNTR

HASP_TOO_MANY_KEYS

HASP_INV_SIG

HASP_LOCAL_COMM_ERR

HASP_DEVICE_ERR

HASP_UPDATE_TOO_OLD

HASP_UPDATE_TOO_NEW

HASP_HARDWARE_MODIFIED

HASP_UNKNOWN_RECIPIENT

HASP_REMOTE_COMM_ERR

HASP_DETACHED_LICENSE_FOUND

HASP_SECURE_STORE_ID_MISMATCH

HASP_NO_VLIB

HASP_VM_DETECTED

HASP_VS_DETECTED

HASP_IDENTITY_RATE_LIMIT_EXCEEDED

HASP_ UPDATE_OUT_OF_SYNC

Usage Notes

hasp_update() applies a V2C or V2CP file to an existing protection key on a local or remote machine.

The Licensing API does not need to be logged in to a Feature on a Sentinel protection key in order to use this function.

hasp_update() can automatically determine where an online detach or cancel license update should be applied. For the operation to succeed, the local License Manager must be active and connected to the remote server.

The update code contains all necessary data to perform the update on a deployed Sentinel protection key including:

>The Sentinel protection key on which the updated information is to be written

>The Vendor Code that is required to access the Sentinel protection key

>The actual update information

Depending on the update data, the function returns an acknowledgement code that is signed/encrypted by the update. The code is evidence that an update has been applied to a license. This function allocates memory for the update information it applies. To release allocated memory resources, use the Free function.

This function is an extension of the main Sentinel Licensing API and is utilized by the Sentinel RUS utility to update Sentinel LDK licenses.

NOTE   When this function is called, a write cycle is performed for the Sentinel protection key. Sentinel HL keys are certified to withstand a specific number of write cycles. For information on the number of write cycles for which Sentinel HL keys are certified, see the Sentinel HL Data Sheet.

Related Topics

Free Function

hasp_update Screen

Detach Function