C API for BALTECH SDK

§ brp_Sec_GetAcMask()

brp_errcode brp_Sec_GetAcMask ( brp_protocol  protocol,
unsigned  SecLevel,
brp_HostSecurityAccessConditionBits AcMask 
)

This command retrieves the Access Condition Mask of a specified security level.

The Access Condition Mask can be set using the command brp_Sec_SetAcMask() or by loading a reader configuration file which defines the respective configuration values Device/HostSecurity/AccessConditionMask.

In case of security level 0 (plain access) the actual Access Condition Mask that is applied by the reader may deviate from the value which is returned by this command. Refer to brp_Sec_GetCurAcMask() .

It is not possible to deny the retrieval of the Access Condition Mask via the "Encryption and Authorization" settings in the configuration. This means that this command will never return the ERR_ACCESS_DENIED status code.

Parameters
[in]protocolused to execute the command
[in]SecLevelSecurity Level to get the Access Condition Mask from. Must be between 0 and 3. If this value is 0xFF, the Access Condition Mask of the current Security Level will be returned.
[out]AcMaskAccess Condition Mask of the Security Level specified in the SecurityLevel parameter. Every Feature in this list can be disabled by not setting the corresponding bit.