A protected application can access the CodeMeter Embedded  using one of the hierarchically structured types of access:

•computer (Sub System Access)

•CmContainer (Box Access)

•single Firm Item (FC, Firm Item Access) or a

•CmContainer entry (FC:PC, Entry Access) in a given subsystem.

Please note the existing hierarchy: a Sub System Access represents a superset of Box Access. A Box Access is a superset of Firm Item Access. A Firm Item Access is a superset of an Entry Access. Anything that can be done with a Sub System Access can also be done with Box Access, but not vice versa!

  • C, C++

Access Mode

Description

Subsystem Access

Subsystem Access accesses a single Subsystem. No CmContainer has to be connected to this subsystem. The only requirement is that CodeMeter License Server (e.g. CodeMeter.exe) is running at this subsystem. Subsystem Access requires the following settings:

•Firm Code must be set to 0 and the CM_ACCESS_SUBSYSTEM flag must be set at the or CMACCESS2 Ctrl parameter.

Box Access

Box Access accesses a single CmContainer. In this case only CmContainer specific tasks can be performed. Box Access requires the following settings:

•If Firm Code = 0 and Product Code = 0, and the box mask or the serial number are not set, then the access to the first found CmContainer at the given subsystem is done.

•If Firm Code = 0 and Product Code = 0, and the box mask and the serial number are set in the or CMACCESS2 BoxInfo parameter, the specified CmContainer is accessed.

Important Note: Accessing Firm Item/Product Item 0:0 fails over the network subsystem due to security reasons. However, due to the hierarchical access structure, you may alternatively use a Firm Item Access or Entry Access.

Firm Item Access

Firm Item Access accesses a single Firm Item. This access mode is, for example, needed for programming a new Product Item into the CmContainer. Access to Firm Item 0 can only be performed locally. Firm Item Access requires the following settings:

•If Product Code = 0, the access to the first found Firm Item in all connected CmContainer at the given subsystem is performed. Additionally please set CM_ACCESS_FIRMITEM in the CMACCESS2 Ctrl parameter to force Firm Item access.

•If Product Code = 0 and a serial number is set in the or CMACCESS2 BoxInfo parameter, then the entry is searched in the specified CmContainer only. Additionally, please set CM_ACCESS_FIRMITEM in the CMACCESS Ctrl/ CMACCESS2 Ctrl parameter to force Firm Item access.

Entry Access

Entry Access accesses a single CmContainer Entry. In this case all entry specific tasks can be performed. Access to entries in Firm Item 0 can only be performed locally. Entry Access can be done using the following settings:

•If Product Code != 0, the access to the first found matching entry in all connected CmContainer at the given subsystem is done.

•If Product Code != 0 and a serial number is set in the / CMACCESS2 BoxInfo parameter, the entry is searched in the specified CmContainer.