CmEmbedded_4c_transp CmActLicenseControl

Description

CmActLicenseControl is a helper function that provides all activation essentials and handles CmActLicense files. Depending on the used flag a buffer or structure is used to describe the request data. If the command needs to return some data, it fills a given structure.

  • C, C++

Syntax

int CMAPIENTRY CmActLicenseControl(HCMSysEntry hcmse, CMULONG flCtrl, const void *pvData, CMUINT cbData, void *pvReturn, CMUINT cbReturn)

Parameter

hcmse contains a handle opened by CmAccess2. The required access mode depends on the operation set in flCtrl.

flCtrl contains one of the following flags to specify the action that is requested:

nav_open CM_GF_ACT_REQUEST creates a remote Context File (*.WibuCmRaC) to request the activation of a CmActLicense. pvData holds a hmtoggle_plus1 CMACTREQUEST structure. pvReturn is filled with a CMBYTE array containing the remote Context File (*.WibuCmRaC). hcmse must be Box Access, Firm Item Access or Entry Access.

Structure CMACTREQUEST

CMACTREQUEST holds information for creating a CmActLicense Context File.

Syntax

typedef struct __CMACTREQUEST {

char mszProductSerialNumber[CMACT_MAX_LEN_VENDORTEXT];

CMULONG mulProductSubType;

CMULONG mulReserved1;

CMBYTE mabLicensorData[CMACT_MAX_LEN_LICENSORDATA];

} CMACTREQUEST;

Parameter

tba.

 

Return

This function returns the number of bytes filled in pvReturn. If the command specified in flCtrl does not fill pvReturn by design, the function returns 1. If an error occurred, 0 will be returned.

Exception:

If pvReturn does not contain enough memory, the number of required bytes will be returned in cbReturn and error code CMERROR_BUFFER_OVERFLOW is set.