CmEmbedded_4c_transp CmSecureDiscWrite

Description

CmSecureDiscWrite is used to write one or several sectors of a Secure Disk partition of a CmContainer.

information_weiss_klein26

For more details on the Secure Disk feature, please contact Wibu-Systems support.
  • C, C++
  • C#

Syntax

int CMAPIENTRY CmSecureDiscWrite(HCMSysEntry hcmse, CMULONG flCtrl, CM_DISC_STATUS *status, const CM_DISC_SECTOR *sector, const CMBYTE *data, CMUINT cbData);

Parameter

hcmse contains a handle opened by CmAccess2 (can be Box Access, Entry Access or Firm Item access).

flCtrl contains the flags available for reading operation of a secure disk partition:

nav_open CM_SECURE_DISC_WRITE writes sector(s) of a secure disk partition (0x00000202).

This flag can be or'ed with CM_SECURE_DISC_WRITE. 'Auto' is the default:

nav_open CM_SECURE_DISC_VERIFY_ON (0x00010000).

nav_open CM_SECURE_DISC_VERIFY_OFF (0x00020000).

nav_open CM_SECURE_DISC_VERIFY_AUTO (0x00000000).

These flags control whether after writing the sectors are read and compared with written sectors.

Default is CM_SECURE_DISC_VERIFY_AUTO, i.e depending on technical conditions a verify is performed. Currently, this is the case, if the file system is not FAT.

If the verify is not successful, the error CMERROR_VERIFY_FAILED (308) returns.

status contains contains information on the secure disk partition (see structure hmtoggle_plus1 CM_DISC_STATUS).

Structure CM_DISC_STATUS

CM_DISC_STATUS contains information on the secure disk partition.

Syntax

typedef struct __CM_DISC_STATUS {

 CMULONG mulErrorCode;

 CMULONG mulEnablingBits;

 CMULONG mulDiscSectorsTotal;

 CMULONG mulWriteOnceCount;

 CMBYTE  mabReserved[64];

} CM_DISC_STATUS;

Parameter

mulErrorCode contains the error code after a read or write operation.

mulEnablingBits contains the enabling bits set for the Secure Disk partition.

mulDiscSectorsTotal contains the total number of sectors (each 512 byte).

mulWriteOnceCount contains the number of the block following a block which is one-time written.

mabReserved[64] is reserved for future purpose.

 

sector contains the sector specification of the secure disk partition (see structure hmtoggle_plus1 CM_DISC_SECTOR).

Structure CM_DISC_SECTOR

CM_DISC_SECTOR contains sector information on the secure disk partition.

Syntax

typedef struct __CM_DISC_SECTOR {

 CMULONG mulNumberOfRequestedSectors;

 CMULONG mulSectorOffset;

 CMBYTE mabReserved[56];

} CM_DISC_SECTOR;

Parameter

mulNumberOfRequestedSectors contains the number of sectors (at least 1).

mulSectorOffset contains the start sector.

mabReserved[56] must be NULLed and is reserved for future purposes.

 

data contains the sector information.

cbData contains the length of data in bytes.

 

Return

If the functions fails, a value of 0 is returned.

Notes