MailWriter Class

Properties   Methods   Events   Config Settings   Errors  

The MailWriter class composes, encrypts, and signs e-mail messages.

Syntax

MailWriter

Remarks

Use MailWriter to compose, sign, and encrypt e-mail messages, and prepare them for sending or saving.

Property List

The following is the full list of the properties of the class with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the class with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the class with short descriptions. Click on the links for further details.

AttachEncoding Property (MailWriter Class)

The encoding to be applied to the attachments.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetAttachEncoding();
int SetAttachEncoding(int iAttachEncoding);

Unicode (Windows)
INT GetAttachEncoding();
INT SetAttachEncoding(INT iAttachEncoding);

ME_AUTO(0), 
ME_8BIT(1), 
ME_BASE_64(2), 
ME_QUOTED_PRINTABLE(3)

int secureblackbox_mailwriter_getattachencoding(void* lpObj);
int secureblackbox_mailwriter_setattachencoding(void* lpObj, int iAttachEncoding);

int GetAttachEncoding();
int SetAttachEncoding(int iAttachEncoding);

Default Value

0

Remarks

Use this property to specify the encoding method for the attached files.

Data Type

Integer

AttachCount Property (MailWriter Class)

The number of records in the Attach arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetAttachCount();
int SetAttachCount(int iAttachCount);

Unicode (Windows)
INT GetAttachCount();
INT SetAttachCount(INT iAttachCount);

int secureblackbox_mailwriter_getattachcount(void* lpObj);
int secureblackbox_mailwriter_setattachcount(void* lpObj, int iAttachCount);

int GetAttachCount();
int SetAttachCount(int iAttachCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• AttachContentSubtype
• AttachContentType
• AttachCreationDate
• AttachData
• AttachDescription
• AttachFilename
• AttachHandle
• AttachID
• AttachModificationDate
• AttachReadDate
• AttachSize

The array indices start at 0 and end at AttachCount - 1.

This property is not available at design time.

Data Type

Integer

AttachContentSubtype Property (MailWriter Class)

Contains the content subtype of the attachment.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAttachContentSubtype(int iAttachIndex);
int SetAttachContentSubtype(int iAttachIndex, const char* lpszAttachContentSubtype);

Unicode (Windows)
LPWSTR GetAttachContentSubtype(INT iAttachIndex);
INT SetAttachContentSubtype(INT iAttachIndex, LPCWSTR lpszAttachContentSubtype);

char* secureblackbox_mailwriter_getattachcontentsubtype(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachcontentsubtype(void* lpObj, int attachindex, const char* lpszAttachContentSubtype);

QString GetAttachContentSubtype(int iAttachIndex);
int SetAttachContentSubtype(int iAttachIndex, QString qsAttachContentSubtype);

Default Value

""

Remarks

Contains the content subtype of the attachment.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

String

AttachContentType Property (MailWriter Class)

Contains the content type of the attachment.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAttachContentType(int iAttachIndex);
int SetAttachContentType(int iAttachIndex, const char* lpszAttachContentType);

Unicode (Windows)
LPWSTR GetAttachContentType(INT iAttachIndex);
INT SetAttachContentType(INT iAttachIndex, LPCWSTR lpszAttachContentType);

char* secureblackbox_mailwriter_getattachcontenttype(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachcontenttype(void* lpObj, int attachindex, const char* lpszAttachContentType);

QString GetAttachContentType(int iAttachIndex);
int SetAttachContentType(int iAttachIndex, QString qsAttachContentType);

Default Value

""

Remarks

Contains the content type of the attachment.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

String

AttachCreationDate Property (MailWriter Class)

The creation date.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAttachCreationDate(int iAttachIndex);
int SetAttachCreationDate(int iAttachIndex, const char* lpszAttachCreationDate);

Unicode (Windows)
LPWSTR GetAttachCreationDate(INT iAttachIndex);
INT SetAttachCreationDate(INT iAttachIndex, LPCWSTR lpszAttachCreationDate);

char* secureblackbox_mailwriter_getattachcreationdate(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachcreationdate(void* lpObj, int attachindex, const char* lpszAttachCreationDate);

QString GetAttachCreationDate(int iAttachIndex);
int SetAttachCreationDate(int iAttachIndex, QString qsAttachCreationDate);

Default Value

""

Remarks

The creation date.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

String

AttachData Property (MailWriter Class)

The content of the attachment.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetAttachData(int iAttachIndex, char* &lpAttachData, int &lenAttachData);
int SetAttachData(int iAttachIndex, const char* lpAttachData, int lenAttachData);

Unicode (Windows)
INT GetAttachData(INT iAttachIndex, LPSTR &lpAttachData, INT &lenAttachData);
INT SetAttachData(INT iAttachIndex, LPCSTR lpAttachData, INT lenAttachData);

int secureblackbox_mailwriter_getattachdata(void* lpObj, int attachindex, char** lpAttachData, int* lenAttachData);
int secureblackbox_mailwriter_setattachdata(void* lpObj, int attachindex, const char* lpAttachData, int lenAttachData);

QByteArray GetAttachData(int iAttachIndex);
int SetAttachData(int iAttachIndex, QByteArray qbaAttachData);

Remarks

The content of the attachment.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

Byte Array

AttachDescription Property (MailWriter Class)

Textual description of the attachment.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAttachDescription(int iAttachIndex);
int SetAttachDescription(int iAttachIndex, const char* lpszAttachDescription);

Unicode (Windows)
LPWSTR GetAttachDescription(INT iAttachIndex);
INT SetAttachDescription(INT iAttachIndex, LPCWSTR lpszAttachDescription);

char* secureblackbox_mailwriter_getattachdescription(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachdescription(void* lpObj, int attachindex, const char* lpszAttachDescription);

QString GetAttachDescription(int iAttachIndex);
int SetAttachDescription(int iAttachIndex, QString qsAttachDescription);

Default Value

""

Remarks

Textual description of the attachment.

This property maps to the Content-Description e-mail header field. Although the field is optional, the ability to associate descriptive information with a given body is often desirable. One example is specifying the title of an image using this property.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

String

AttachFilename Property (MailWriter Class)

Specifies the name of the attachment file.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAttachFilename(int iAttachIndex);
int SetAttachFilename(int iAttachIndex, const char* lpszAttachFilename);

Unicode (Windows)
LPWSTR GetAttachFilename(INT iAttachIndex);
INT SetAttachFilename(INT iAttachIndex, LPCWSTR lpszAttachFilename);

char* secureblackbox_mailwriter_getattachfilename(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachfilename(void* lpObj, int attachindex, const char* lpszAttachFilename);

QString GetAttachFilename(int iAttachIndex);
int SetAttachFilename(int iAttachIndex, QString qsAttachFilename);

Default Value

""

Remarks

Specifies the name of the attachment file.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

String

AttachHandle Property (MailWriter Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetAttachHandle(int iAttachIndex);
int SetAttachHandle(int iAttachIndex, int64 lAttachHandle);

Unicode (Windows)
LONG64 GetAttachHandle(INT iAttachIndex);
INT SetAttachHandle(INT iAttachIndex, LONG64 lAttachHandle);

int64 secureblackbox_mailwriter_getattachhandle(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachhandle(void* lpObj, int attachindex, int64 lAttachHandle);

qint64 GetAttachHandle(int iAttachIndex);
int SetAttachHandle(int iAttachIndex, qint64 lAttachHandle);

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation.

 
 Copy
  pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

Long64

AttachID Property (MailWriter Class)

Contains the attachment's unique identifier.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAttachID(int iAttachIndex);
int SetAttachID(int iAttachIndex, const char* lpszAttachID);

Unicode (Windows)
LPWSTR GetAttachID(INT iAttachIndex);
INT SetAttachID(INT iAttachIndex, LPCWSTR lpszAttachID);

char* secureblackbox_mailwriter_getattachid(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachid(void* lpObj, int attachindex, const char* lpszAttachID);

QString GetAttachID(int iAttachIndex);
int SetAttachID(int iAttachIndex, QString qsAttachID);

Default Value

""

Remarks

Contains the attachment's unique identifier.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

String

AttachModificationDate Property (MailWriter Class)

Specifies the date and time of the file's last modification.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAttachModificationDate(int iAttachIndex);
int SetAttachModificationDate(int iAttachIndex, const char* lpszAttachModificationDate);

Unicode (Windows)
LPWSTR GetAttachModificationDate(INT iAttachIndex);
INT SetAttachModificationDate(INT iAttachIndex, LPCWSTR lpszAttachModificationDate);

char* secureblackbox_mailwriter_getattachmodificationdate(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachmodificationdate(void* lpObj, int attachindex, const char* lpszAttachModificationDate);

QString GetAttachModificationDate(int iAttachIndex);
int SetAttachModificationDate(int iAttachIndex, QString qsAttachModificationDate);

Default Value

""

Remarks

Specifies the date and time of the file's last modification.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

String

AttachReadDate Property (MailWriter Class)

Specifies the file's last read date.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAttachReadDate(int iAttachIndex);
int SetAttachReadDate(int iAttachIndex, const char* lpszAttachReadDate);

Unicode (Windows)
LPWSTR GetAttachReadDate(INT iAttachIndex);
INT SetAttachReadDate(INT iAttachIndex, LPCWSTR lpszAttachReadDate);

char* secureblackbox_mailwriter_getattachreaddate(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachreaddate(void* lpObj, int attachindex, const char* lpszAttachReadDate);

QString GetAttachReadDate(int iAttachIndex);
int SetAttachReadDate(int iAttachIndex, QString qsAttachReadDate);

Default Value

""

Remarks

Specifies the file's last read date.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

String

AttachSize Property (MailWriter Class)

The attachment's size in bytes.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetAttachSize(int iAttachIndex);
int SetAttachSize(int iAttachIndex, int64 lAttachSize);

Unicode (Windows)
LONG64 GetAttachSize(INT iAttachIndex);
INT SetAttachSize(INT iAttachIndex, LONG64 lAttachSize);

int64 secureblackbox_mailwriter_getattachsize(void* lpObj, int attachindex);
int secureblackbox_mailwriter_setattachsize(void* lpObj, int attachindex, int64 lAttachSize);

qint64 GetAttachSize(int iAttachIndex);
int SetAttachSize(int iAttachIndex, qint64 lAttachSize);

Default Value

0

Remarks

The attachment's size in bytes.

The AttachIndex parameter specifies the index of the item in the array. The size of the array is controlled by the AttachCount property.

This property is not available at design time.

Data Type

Long64

BccAddrCount Property (MailWriter Class)

The number of records in the BccAddr arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetBccAddrCount();
int SetBccAddrCount(int iBccAddrCount);

Unicode (Windows)
INT GetBccAddrCount();
INT SetBccAddrCount(INT iBccAddrCount);

int secureblackbox_mailwriter_getbccaddrcount(void* lpObj);
int secureblackbox_mailwriter_setbccaddrcount(void* lpObj, int iBccAddrCount);

int GetBccAddrCount();
int SetBccAddrCount(int iBccAddrCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• BccAddrAddress
• BccAddrDisplayName
• BccAddrGroupName

The array indices start at 0 and end at BccAddrCount - 1.

This property is not available at design time.

Data Type

Integer

BccAddrAddress Property (MailWriter Class)

Contains the e-mail address in the form of john@doe.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetBccAddrAddress(int iBccAddrIndex);
int SetBccAddrAddress(int iBccAddrIndex, const char* lpszBccAddrAddress);

Unicode (Windows)
LPWSTR GetBccAddrAddress(INT iBccAddrIndex);
INT SetBccAddrAddress(INT iBccAddrIndex, LPCWSTR lpszBccAddrAddress);

char* secureblackbox_mailwriter_getbccaddraddress(void* lpObj, int bccaddrindex);
int secureblackbox_mailwriter_setbccaddraddress(void* lpObj, int bccaddrindex, const char* lpszBccAddrAddress);

QString GetBccAddrAddress(int iBccAddrIndex);
int SetBccAddrAddress(int iBccAddrIndex, QString qsBccAddrAddress);

Default Value

""

Remarks

Contains the e-mail address in the form of john@doe.com.

The BccAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the BccAddrCount property.

This property is not available at design time.

Data Type

String

BccAddrDisplayName Property (MailWriter Class)

Contains the friendly name of the user of this address, such as John Doe.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetBccAddrDisplayName(int iBccAddrIndex);
int SetBccAddrDisplayName(int iBccAddrIndex, const char* lpszBccAddrDisplayName);

Unicode (Windows)
LPWSTR GetBccAddrDisplayName(INT iBccAddrIndex);
INT SetBccAddrDisplayName(INT iBccAddrIndex, LPCWSTR lpszBccAddrDisplayName);

char* secureblackbox_mailwriter_getbccaddrdisplayname(void* lpObj, int bccaddrindex);
int secureblackbox_mailwriter_setbccaddrdisplayname(void* lpObj, int bccaddrindex, const char* lpszBccAddrDisplayName);

QString GetBccAddrDisplayName(int iBccAddrIndex);
int SetBccAddrDisplayName(int iBccAddrIndex, QString qsBccAddrDisplayName);

Default Value

""

Remarks

Contains the friendly name of the user of this address, such as John Doe.

The BccAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the BccAddrCount property.

This property is not available at design time.

Data Type

String

BccAddrGroupName Property (MailWriter Class)

The name of the group this address belongs to.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetBccAddrGroupName(int iBccAddrIndex);
int SetBccAddrGroupName(int iBccAddrIndex, const char* lpszBccAddrGroupName);

Unicode (Windows)
LPWSTR GetBccAddrGroupName(INT iBccAddrIndex);
INT SetBccAddrGroupName(INT iBccAddrIndex, LPCWSTR lpszBccAddrGroupName);

char* secureblackbox_mailwriter_getbccaddrgroupname(void* lpObj, int bccaddrindex);
int secureblackbox_mailwriter_setbccaddrgroupname(void* lpObj, int bccaddrindex, const char* lpszBccAddrGroupName);

QString GetBccAddrGroupName(int iBccAddrIndex);
int SetBccAddrGroupName(int iBccAddrIndex, QString qsBccAddrGroupName);

Default Value

""

Remarks

The name of the group this address belongs to.

The BccAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the BccAddrCount property.

This property is not available at design time.

Data Type

String

CcAddrCount Property (MailWriter Class)

The number of records in the CcAddr arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCcAddrCount();
int SetCcAddrCount(int iCcAddrCount);

Unicode (Windows)
INT GetCcAddrCount();
INT SetCcAddrCount(INT iCcAddrCount);

int secureblackbox_mailwriter_getccaddrcount(void* lpObj);
int secureblackbox_mailwriter_setccaddrcount(void* lpObj, int iCcAddrCount);

int GetCcAddrCount();
int SetCcAddrCount(int iCcAddrCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• CcAddrAddress
• CcAddrDisplayName
• CcAddrGroupName

The array indices start at 0 and end at CcAddrCount - 1.

This property is not available at design time.

Data Type

Integer

CcAddrAddress Property (MailWriter Class)

Contains the e-mail address in the form of john@doe.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCcAddrAddress(int iCcAddrIndex);
int SetCcAddrAddress(int iCcAddrIndex, const char* lpszCcAddrAddress);

Unicode (Windows)
LPWSTR GetCcAddrAddress(INT iCcAddrIndex);
INT SetCcAddrAddress(INT iCcAddrIndex, LPCWSTR lpszCcAddrAddress);

char* secureblackbox_mailwriter_getccaddraddress(void* lpObj, int ccaddrindex);
int secureblackbox_mailwriter_setccaddraddress(void* lpObj, int ccaddrindex, const char* lpszCcAddrAddress);

QString GetCcAddrAddress(int iCcAddrIndex);
int SetCcAddrAddress(int iCcAddrIndex, QString qsCcAddrAddress);

Default Value

""

Remarks

Contains the e-mail address in the form of john@doe.com.

The CcAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CcAddrCount property.

This property is not available at design time.

Data Type

String

CcAddrDisplayName Property (MailWriter Class)

Contains the friendly name of the user of this address, such as John Doe.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCcAddrDisplayName(int iCcAddrIndex);
int SetCcAddrDisplayName(int iCcAddrIndex, const char* lpszCcAddrDisplayName);

Unicode (Windows)
LPWSTR GetCcAddrDisplayName(INT iCcAddrIndex);
INT SetCcAddrDisplayName(INT iCcAddrIndex, LPCWSTR lpszCcAddrDisplayName);

char* secureblackbox_mailwriter_getccaddrdisplayname(void* lpObj, int ccaddrindex);
int secureblackbox_mailwriter_setccaddrdisplayname(void* lpObj, int ccaddrindex, const char* lpszCcAddrDisplayName);

QString GetCcAddrDisplayName(int iCcAddrIndex);
int SetCcAddrDisplayName(int iCcAddrIndex, QString qsCcAddrDisplayName);

Default Value

""

Remarks

Contains the friendly name of the user of this address, such as John Doe.

The CcAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CcAddrCount property.

This property is not available at design time.

Data Type

String

CcAddrGroupName Property (MailWriter Class)

The name of the group this address belongs to.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCcAddrGroupName(int iCcAddrIndex);
int SetCcAddrGroupName(int iCcAddrIndex, const char* lpszCcAddrGroupName);

Unicode (Windows)
LPWSTR GetCcAddrGroupName(INT iCcAddrIndex);
INT SetCcAddrGroupName(INT iCcAddrIndex, LPCWSTR lpszCcAddrGroupName);

char* secureblackbox_mailwriter_getccaddrgroupname(void* lpObj, int ccaddrindex);
int secureblackbox_mailwriter_setccaddrgroupname(void* lpObj, int ccaddrindex, const char* lpszCcAddrGroupName);

QString GetCcAddrGroupName(int iCcAddrIndex);
int SetCcAddrGroupName(int iCcAddrIndex, QString qsCcAddrGroupName);

Default Value

""

Remarks

The name of the group this address belongs to.

The CcAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CcAddrCount property.

This property is not available at design time.

Data Type

String

Charset Property (MailWriter Class)

The charset to apply to Message .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCharset();
int SetCharset(const char* lpszCharset);

Unicode (Windows)
LPWSTR GetCharset();
INT SetCharset(LPCWSTR lpszCharset);

char* secureblackbox_mailwriter_getcharset(void* lpObj);
int secureblackbox_mailwriter_setcharset(void* lpObj, const char* lpszCharset);

QString GetCharset();
int SetCharset(QString qsCharset);

Default Value

"utf-8"

Remarks

Use this property to specify the character set to use in the message.

Data Type

String

EncryptionCertCount Property (MailWriter Class)

The number of records in the EncryptionCert arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetEncryptionCertCount();
int SetEncryptionCertCount(int iEncryptionCertCount);

Unicode (Windows)
INT GetEncryptionCertCount();
INT SetEncryptionCertCount(INT iEncryptionCertCount);

int secureblackbox_mailwriter_getencryptioncertcount(void* lpObj);
int secureblackbox_mailwriter_setencryptioncertcount(void* lpObj, int iEncryptionCertCount);

int GetEncryptionCertCount();
int SetEncryptionCertCount(int iEncryptionCertCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• EncryptionCertBytes
• EncryptionCertHandle

The array indices start at 0 and end at EncryptionCertCount - 1.

This property is not available at design time.

Data Type

Integer

EncryptionCertBytes Property (MailWriter Class)

Returns the raw certificate data in DER format.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetEncryptionCertBytes(int iEncryptionCertIndex, char* &lpEncryptionCertBytes, int &lenEncryptionCertBytes);

Unicode (Windows)
INT GetEncryptionCertBytes(INT iEncryptionCertIndex, LPSTR &lpEncryptionCertBytes, INT &lenEncryptionCertBytes);

int secureblackbox_mailwriter_getencryptioncertbytes(void* lpObj, int encryptioncertindex, char** lpEncryptionCertBytes, int* lenEncryptionCertBytes);

QByteArray GetEncryptionCertBytes(int iEncryptionCertIndex);

Remarks

Returns the raw certificate data in DER format.

The EncryptionCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the EncryptionCertCount property.

This property is read-only and not available at design time.

Data Type

Byte Array

EncryptionCertHandle Property (MailWriter Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetEncryptionCertHandle(int iEncryptionCertIndex);
int SetEncryptionCertHandle(int iEncryptionCertIndex, int64 lEncryptionCertHandle);

Unicode (Windows)
LONG64 GetEncryptionCertHandle(INT iEncryptionCertIndex);
INT SetEncryptionCertHandle(INT iEncryptionCertIndex, LONG64 lEncryptionCertHandle);

int64 secureblackbox_mailwriter_getencryptioncerthandle(void* lpObj, int encryptioncertindex);
int secureblackbox_mailwriter_setencryptioncerthandle(void* lpObj, int encryptioncertindex, int64 lEncryptionCertHandle);

qint64 GetEncryptionCertHandle(int iEncryptionCertIndex);
int SetEncryptionCertHandle(int iEncryptionCertIndex, qint64 lEncryptionCertHandle);

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation.

 
 Copy
  pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The EncryptionCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the EncryptionCertCount property.

This property is not available at design time.

Data Type

Long64

ExternalCryptoAsyncDocumentID Property (MailWriter Class)

Specifies an optional document ID for SignAsyncBegin() and SignAsyncEnd() calls.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetExternalCryptoAsyncDocumentID();
int SetExternalCryptoAsyncDocumentID(const char* lpszExternalCryptoAsyncDocumentID);

Unicode (Windows)
LPWSTR GetExternalCryptoAsyncDocumentID();
INT SetExternalCryptoAsyncDocumentID(LPCWSTR lpszExternalCryptoAsyncDocumentID);

char* secureblackbox_mailwriter_getexternalcryptoasyncdocumentid(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptoasyncdocumentid(void* lpObj, const char* lpszExternalCryptoAsyncDocumentID);

QString GetExternalCryptoAsyncDocumentID();
int SetExternalCryptoAsyncDocumentID(QString qsExternalCryptoAsyncDocumentID);

Default Value

""

Remarks

Specifies an optional document ID for SignAsyncBegin() and SignAsyncEnd() calls.

Use this property when working with multi-signature DCAuth requests and responses to uniquely identify documents signed within a larger batch. On the completion stage, this value helps the signing component identify the correct signature in the returned batch of responses.

If using batched requests, make sure to set this property to the same value on both the pre-signing (SignAsyncBegin) and completion (SignAsyncEnd) stages.

Data Type

String

ExternalCryptoCustomParams Property (MailWriter Class)

Custom parameters to be passed to the signing service (uninterpreted).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetExternalCryptoCustomParams();
int SetExternalCryptoCustomParams(const char* lpszExternalCryptoCustomParams);

Unicode (Windows)
LPWSTR GetExternalCryptoCustomParams();
INT SetExternalCryptoCustomParams(LPCWSTR lpszExternalCryptoCustomParams);

char* secureblackbox_mailwriter_getexternalcryptocustomparams(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptocustomparams(void* lpObj, const char* lpszExternalCryptoCustomParams);

QString GetExternalCryptoCustomParams();
int SetExternalCryptoCustomParams(QString qsExternalCryptoCustomParams);

Default Value

""

Remarks

Custom parameters to be passed to the signing service (uninterpreted).

This property is not available at design time.

Data Type

String

ExternalCryptoData Property (MailWriter Class)

Additional data to be included in the async state and mirrored back by the requestor.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetExternalCryptoData();
int SetExternalCryptoData(const char* lpszExternalCryptoData);

Unicode (Windows)
LPWSTR GetExternalCryptoData();
INT SetExternalCryptoData(LPCWSTR lpszExternalCryptoData);

char* secureblackbox_mailwriter_getexternalcryptodata(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptodata(void* lpObj, const char* lpszExternalCryptoData);

QString GetExternalCryptoData();
int SetExternalCryptoData(QString qsExternalCryptoData);

Default Value

""

Remarks

Additional data to be included in the async state and mirrored back by the requestor.

This property is not available at design time.

Data Type

String

ExternalCryptoExternalHashCalculation Property (MailWriter Class)

Specifies whether the message hash is to be calculated at the external endpoint.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetExternalCryptoExternalHashCalculation();
int SetExternalCryptoExternalHashCalculation(int bExternalCryptoExternalHashCalculation);

Unicode (Windows)
BOOL GetExternalCryptoExternalHashCalculation();
INT SetExternalCryptoExternalHashCalculation(BOOL bExternalCryptoExternalHashCalculation);

int secureblackbox_mailwriter_getexternalcryptoexternalhashcalculation(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptoexternalhashcalculation(void* lpObj, int bExternalCryptoExternalHashCalculation);

bool GetExternalCryptoExternalHashCalculation();
int SetExternalCryptoExternalHashCalculation(bool bExternalCryptoExternalHashCalculation);

Default Value

FALSE

Remarks

Specifies whether the message hash is to be calculated at the external endpoint. Please note that this mode is not supported by the DCAuth class.

If set to true, the class will pass a few kilobytes of to-be-signed data from the document to the OnExternalSign event. This only applies when SignExternal() is called.

Data Type

Boolean

ExternalCryptoHashAlgorithm Property (MailWriter Class)

Specifies the request's signature hash algorithm.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetExternalCryptoHashAlgorithm();
int SetExternalCryptoHashAlgorithm(const char* lpszExternalCryptoHashAlgorithm);

Unicode (Windows)
LPWSTR GetExternalCryptoHashAlgorithm();
INT SetExternalCryptoHashAlgorithm(LPCWSTR lpszExternalCryptoHashAlgorithm);

char* secureblackbox_mailwriter_getexternalcryptohashalgorithm(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptohashalgorithm(void* lpObj, const char* lpszExternalCryptoHashAlgorithm);

QString GetExternalCryptoHashAlgorithm();
int SetExternalCryptoHashAlgorithm(QString qsExternalCryptoHashAlgorithm);

Default Value

"SHA256"

Remarks

Specifies the request's signature hash algorithm.

Data Type

String

ExternalCryptoKeyID Property (MailWriter Class)

The ID of the pre-shared key used for DC request authentication.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetExternalCryptoKeyID();
int SetExternalCryptoKeyID(const char* lpszExternalCryptoKeyID);

Unicode (Windows)
LPWSTR GetExternalCryptoKeyID();
INT SetExternalCryptoKeyID(LPCWSTR lpszExternalCryptoKeyID);

char* secureblackbox_mailwriter_getexternalcryptokeyid(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptokeyid(void* lpObj, const char* lpszExternalCryptoKeyID);

QString GetExternalCryptoKeyID();
int SetExternalCryptoKeyID(QString qsExternalCryptoKeyID);

Default Value

""

Remarks

The ID of the pre-shared key used for DC request authentication.

Asynchronous DCAuth-driven communication requires that parties authenticate each other with a secret pre-shared cryptographic key. This provides an extra protection layer for the protocol and diminishes the risk of the private key becoming abused by foreign parties. Use this property to provide the pre-shared key identifier, and use ExternalCryptoKeySecret to pass the key itself.

The same KeyID/KeySecret pair should be used on the DCAuth side for the signing requests to be accepted.

Note: The KeyID/KeySecret scheme is very similar to the AuthKey scheme used in various Cloud service providers to authenticate users.

Example:

 
 Copy
  signer.ExternalCrypto.KeyID = "MainSigningKey";
  signer.ExternalCrypto.KeySecret = "abcdef0123456789";

Data Type

String

ExternalCryptoKeySecret Property (MailWriter Class)

The pre-shared key used for DC request authentication.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetExternalCryptoKeySecret();
int SetExternalCryptoKeySecret(const char* lpszExternalCryptoKeySecret);

Unicode (Windows)
LPWSTR GetExternalCryptoKeySecret();
INT SetExternalCryptoKeySecret(LPCWSTR lpszExternalCryptoKeySecret);

char* secureblackbox_mailwriter_getexternalcryptokeysecret(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptokeysecret(void* lpObj, const char* lpszExternalCryptoKeySecret);

QString GetExternalCryptoKeySecret();
int SetExternalCryptoKeySecret(QString qsExternalCryptoKeySecret);

Default Value

""

Remarks

The pre-shared key used for DC request authentication. This key must be set and match the key used by the DCAuth counterpart for the scheme to work.

Read more about configuring authentication in the ExternalCryptoKeyID topic.

Data Type

String

ExternalCryptoMethod Property (MailWriter Class)

Specifies the asynchronous signing method.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetExternalCryptoMethod();
int SetExternalCryptoMethod(int iExternalCryptoMethod);

Unicode (Windows)
INT GetExternalCryptoMethod();
INT SetExternalCryptoMethod(INT iExternalCryptoMethod);

ASMD_PKCS1(0), 
ASMD_PKCS7(1)

int secureblackbox_mailwriter_getexternalcryptomethod(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptomethod(void* lpObj, int iExternalCryptoMethod);

int GetExternalCryptoMethod();
int SetExternalCryptoMethod(int iExternalCryptoMethod);

Default Value

0

Remarks

Specifies the asynchronous signing method. This is typically defined by the DC server capabilities and setup.

Available options:

Data Type

Integer

ExternalCryptoMode Property (MailWriter Class)

Specifies the external cryptography mode.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetExternalCryptoMode();
int SetExternalCryptoMode(int iExternalCryptoMode);

Unicode (Windows)
INT GetExternalCryptoMode();
INT SetExternalCryptoMode(INT iExternalCryptoMode);

ECM_DEFAULT(0), 
ECM_DISABLED(1), 
ECM_GENERIC(2), 
ECM_DCAUTH(3), 
ECM_DCAUTH_JSON(4)

int secureblackbox_mailwriter_getexternalcryptomode(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptomode(void* lpObj, int iExternalCryptoMode);

int GetExternalCryptoMode();
int SetExternalCryptoMode(int iExternalCryptoMode);

Default Value

0

Remarks

Specifies the external cryptography mode.

Available options:

This property is not available at design time.

Data Type

Integer

ExternalCryptoPublicKeyAlgorithm Property (MailWriter Class)

Provide the public key algorithm here if the certificate is not available on the pre-signing stage.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetExternalCryptoPublicKeyAlgorithm();
int SetExternalCryptoPublicKeyAlgorithm(const char* lpszExternalCryptoPublicKeyAlgorithm);

Unicode (Windows)
LPWSTR GetExternalCryptoPublicKeyAlgorithm();
INT SetExternalCryptoPublicKeyAlgorithm(LPCWSTR lpszExternalCryptoPublicKeyAlgorithm);

char* secureblackbox_mailwriter_getexternalcryptopublickeyalgorithm(void* lpObj);
int secureblackbox_mailwriter_setexternalcryptopublickeyalgorithm(void* lpObj, const char* lpszExternalCryptoPublicKeyAlgorithm);

QString GetExternalCryptoPublicKeyAlgorithm();
int SetExternalCryptoPublicKeyAlgorithm(QString qsExternalCryptoPublicKeyAlgorithm);

Default Value

""

Remarks

Provide the public key algorithm here if the certificate is not available on the pre-signing stage.

Data Type

String

FIPSMode Property (MailWriter Class)

Reserved.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetFIPSMode();
int SetFIPSMode(int bFIPSMode);

Unicode (Windows)
BOOL GetFIPSMode();
INT SetFIPSMode(BOOL bFIPSMode);

int secureblackbox_mailwriter_getfipsmode(void* lpObj);
int secureblackbox_mailwriter_setfipsmode(void* lpObj, int bFIPSMode);

bool GetFIPSMode();
int SetFIPSMode(bool bFIPSMode);

Default Value

FALSE

Remarks

This property is reserved for future use.

Data Type

Boolean

FromAddrCount Property (MailWriter Class)

The number of records in the FromAddr arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetFromAddrCount();
int SetFromAddrCount(int iFromAddrCount);

Unicode (Windows)
INT GetFromAddrCount();
INT SetFromAddrCount(INT iFromAddrCount);

int secureblackbox_mailwriter_getfromaddrcount(void* lpObj);
int secureblackbox_mailwriter_setfromaddrcount(void* lpObj, int iFromAddrCount);

int GetFromAddrCount();
int SetFromAddrCount(int iFromAddrCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• FromAddrAddress
• FromAddrDisplayName
• FromAddrGroupName

The array indices start at 0 and end at FromAddrCount - 1.

This property is not available at design time.

Data Type

Integer

FromAddrAddress Property (MailWriter Class)

Contains the e-mail address in the form of john@doe.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetFromAddrAddress(int iFromAddrIndex);
int SetFromAddrAddress(int iFromAddrIndex, const char* lpszFromAddrAddress);

Unicode (Windows)
LPWSTR GetFromAddrAddress(INT iFromAddrIndex);
INT SetFromAddrAddress(INT iFromAddrIndex, LPCWSTR lpszFromAddrAddress);

char* secureblackbox_mailwriter_getfromaddraddress(void* lpObj, int fromaddrindex);
int secureblackbox_mailwriter_setfromaddraddress(void* lpObj, int fromaddrindex, const char* lpszFromAddrAddress);

QString GetFromAddrAddress(int iFromAddrIndex);
int SetFromAddrAddress(int iFromAddrIndex, QString qsFromAddrAddress);

Default Value

""

Remarks

Contains the e-mail address in the form of john@doe.com.

The FromAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FromAddrCount property.

This property is not available at design time.

Data Type

String

FromAddrDisplayName Property (MailWriter Class)

Contains the friendly name of the user of this address, such as John Doe.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetFromAddrDisplayName(int iFromAddrIndex);
int SetFromAddrDisplayName(int iFromAddrIndex, const char* lpszFromAddrDisplayName);

Unicode (Windows)
LPWSTR GetFromAddrDisplayName(INT iFromAddrIndex);
INT SetFromAddrDisplayName(INT iFromAddrIndex, LPCWSTR lpszFromAddrDisplayName);

char* secureblackbox_mailwriter_getfromaddrdisplayname(void* lpObj, int fromaddrindex);
int secureblackbox_mailwriter_setfromaddrdisplayname(void* lpObj, int fromaddrindex, const char* lpszFromAddrDisplayName);

QString GetFromAddrDisplayName(int iFromAddrIndex);
int SetFromAddrDisplayName(int iFromAddrIndex, QString qsFromAddrDisplayName);

Default Value

""

Remarks

Contains the friendly name of the user of this address, such as John Doe.

The FromAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FromAddrCount property.

This property is not available at design time.

Data Type

String

FromAddrGroupName Property (MailWriter Class)

The name of the group this address belongs to.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetFromAddrGroupName(int iFromAddrIndex);
int SetFromAddrGroupName(int iFromAddrIndex, const char* lpszFromAddrGroupName);

Unicode (Windows)
LPWSTR GetFromAddrGroupName(INT iFromAddrIndex);
INT SetFromAddrGroupName(INT iFromAddrIndex, LPCWSTR lpszFromAddrGroupName);

char* secureblackbox_mailwriter_getfromaddrgroupname(void* lpObj, int fromaddrindex);
int secureblackbox_mailwriter_setfromaddrgroupname(void* lpObj, int fromaddrindex, const char* lpszFromAddrGroupName);

QString GetFromAddrGroupName(int iFromAddrIndex);
int SetFromAddrGroupName(int iFromAddrIndex, QString qsFromAddrGroupName);

Default Value

""

Remarks

The name of the group this address belongs to.

The FromAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FromAddrCount property.

This property is not available at design time.

Data Type

String

HeaderEncoding Property (MailWriter Class)

The encoding to be applied to the message header.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetHeaderEncoding();
int SetHeaderEncoding(int iHeaderEncoding);

Unicode (Windows)
INT GetHeaderEncoding();
INT SetHeaderEncoding(INT iHeaderEncoding);

ME_AUTO(0), 
ME_8BIT(1), 
ME_BASE_64(2), 
ME_QUOTED_PRINTABLE(3)

int secureblackbox_mailwriter_getheaderencoding(void* lpObj);
int secureblackbox_mailwriter_setheaderencoding(void* lpObj, int iHeaderEncoding);

int GetHeaderEncoding();
int SetHeaderEncoding(int iHeaderEncoding);

Default Value

0

Remarks

Use this property to specify the encoding to use with the message header.

Data Type

Integer

Mailer Property (MailWriter Class)

The name of the software used to compose and/or send the message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMailer();
int SetMailer(const char* lpszMailer);

Unicode (Windows)
LPWSTR GetMailer();
INT SetMailer(LPCWSTR lpszMailer);

char* secureblackbox_mailwriter_getmailer(void* lpObj);
int secureblackbox_mailwriter_setmailer(void* lpObj, const char* lpszMailer);

QString GetMailer();
int SetMailer(QString qsMailer);

Default Value

""

Remarks

Use this property to specify the software that was used to compose and send this message.

Data Type

String

MsgAttachmentCount Property (MailWriter Class)

Returns the number of attachments in this message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetMsgAttachmentCount();

Unicode (Windows)
INT GetMsgAttachmentCount();

int secureblackbox_mailwriter_getmsgattachmentcount(void* lpObj);

int GetMsgAttachmentCount();

Default Value

0

Remarks

Returns the number of attachments in this message.

This property is read-only and not available at design time.

Data Type

Integer

MsgBcc Property (MailWriter Class)

The contents of the BCC header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgBcc();
int SetMsgBcc(const char* lpszMsgBcc);

Unicode (Windows)
LPWSTR GetMsgBcc();
INT SetMsgBcc(LPCWSTR lpszMsgBcc);

char* secureblackbox_mailwriter_getmsgbcc(void* lpObj);
int secureblackbox_mailwriter_setmsgbcc(void* lpObj, const char* lpszMsgBcc);

QString GetMsgBcc();
int SetMsgBcc(QString qsMsgBcc);

Default Value

""

Remarks

The contents of the BCC header field.

The BCC header field contains the addresses of secondary recipients of the message whose addresses are not to be revealed to other recipients of the message. Mail servers remove the BCC header when processing the message and use its value for dispatching the message only.

This property is not available at design time.

Data Type

String

MsgCc Property (MailWriter Class)

The value of the CC header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgCc();
int SetMsgCc(const char* lpszMsgCc);

Unicode (Windows)
LPWSTR GetMsgCc();
INT SetMsgCc(LPCWSTR lpszMsgCc);

char* secureblackbox_mailwriter_getmsgcc(void* lpObj);
int secureblackbox_mailwriter_setmsgcc(void* lpObj, const char* lpszMsgCc);

QString GetMsgCc();
int SetMsgCc(QString qsMsgCc);

Default Value

""

Remarks

The value of the CC header field.

The CC field contains the addresses of secondary recipients of the message.

This property is not available at design time.

Data Type

String

MsgComments Property (MailWriter Class)

Contains additional information about the message body.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgComments();
int SetMsgComments(const char* lpszMsgComments);

Unicode (Windows)
LPWSTR GetMsgComments();
INT SetMsgComments(LPCWSTR lpszMsgComments);

char* secureblackbox_mailwriter_getmsgcomments(void* lpObj);
int secureblackbox_mailwriter_setmsgcomments(void* lpObj, const char* lpszMsgComments);

QString GetMsgComments();
int SetMsgComments(QString qsMsgComments);

Default Value

""

Remarks

Contains additional information about the message body.

This property is not available at design time.

Data Type

String

MsgDate Property (MailWriter Class)

The date and time when the message entered the mail delivery system.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgDate();
int SetMsgDate(const char* lpszMsgDate);

Unicode (Windows)
LPWSTR GetMsgDate();
INT SetMsgDate(LPCWSTR lpszMsgDate);

char* secureblackbox_mailwriter_getmsgdate(void* lpObj);
int secureblackbox_mailwriter_setmsgdate(void* lpObj, const char* lpszMsgDate);

QString GetMsgDate();
int SetMsgDate(QString qsMsgDate);

Default Value

""

Remarks

The date and time when the message entered the mail delivery system.

This field contains the date and time at which the creator of the message posted the message to the mail delivery system.

The date is returned and accepted in UTC time zone.

This property is not available at design time.

Data Type

String

MsgDeliveryReceipt Property (MailWriter Class)

Enables delivery notification.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetMsgDeliveryReceipt();
int SetMsgDeliveryReceipt(int bMsgDeliveryReceipt);

Unicode (Windows)
BOOL GetMsgDeliveryReceipt();
INT SetMsgDeliveryReceipt(BOOL bMsgDeliveryReceipt);

int secureblackbox_mailwriter_getmsgdeliveryreceipt(void* lpObj);
int secureblackbox_mailwriter_setmsgdeliveryreceipt(void* lpObj, int bMsgDeliveryReceipt);

bool GetMsgDeliveryReceipt();
int SetMsgDeliveryReceipt(bool bMsgDeliveryReceipt);

Default Value

FALSE

Remarks

Enables delivery notification.

This property is not available at design time.

Data Type

Boolean

MsgFrom Property (MailWriter Class)

Contains the value of the From header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgFrom();
int SetMsgFrom(const char* lpszMsgFrom);

Unicode (Windows)
LPWSTR GetMsgFrom();
INT SetMsgFrom(LPCWSTR lpszMsgFrom);

char* secureblackbox_mailwriter_getmsgfrom(void* lpObj);
int secureblackbox_mailwriter_setmsgfrom(void* lpObj, const char* lpszMsgFrom);

QString GetMsgFrom();
int SetMsgFrom(QString qsMsgFrom);

Default Value

""

Remarks

Contains the value of the From header field.

This field contains the address(es) of the message author(s). If the actual sender is not the author of the message, use MsgSender to specify the sender separately.

This property is not available at design time.

Data Type

String

MsgHandle Property (MailWriter Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetMsgHandle();
int SetMsgHandle(int64 lMsgHandle);

Unicode (Windows)
LONG64 GetMsgHandle();
INT SetMsgHandle(LONG64 lMsgHandle);

int64 secureblackbox_mailwriter_getmsghandle(void* lpObj);
int secureblackbox_mailwriter_setmsghandle(void* lpObj, int64 lMsgHandle);

qint64 GetMsgHandle();
int SetMsgHandle(qint64 lMsgHandle);

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation.

 
 Copy
  pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

This property is not available at design time.

Data Type

Long64

MsgHtmlText Property (MailWriter Class)

The HTML version of the message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgHtmlText();
int SetMsgHtmlText(const char* lpszMsgHtmlText);

Unicode (Windows)
LPWSTR GetMsgHtmlText();
INT SetMsgHtmlText(LPCWSTR lpszMsgHtmlText);

char* secureblackbox_mailwriter_getmsghtmltext(void* lpObj);
int secureblackbox_mailwriter_setmsghtmltext(void* lpObj, const char* lpszMsgHtmlText);

QString GetMsgHtmlText();
int SetMsgHtmlText(QString qsMsgHtmlText);

Default Value

""

Remarks

The HTML version of the message.

This property is not available at design time.

Data Type

String

MsgID Property (MailWriter Class)

The contents of the Message-ID header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgID();
int SetMsgID(const char* lpszMsgID);

Unicode (Windows)
LPWSTR GetMsgID();
INT SetMsgID(LPCWSTR lpszMsgID);

char* secureblackbox_mailwriter_getmsgid(void* lpObj);
int secureblackbox_mailwriter_setmsgid(void* lpObj, const char* lpszMsgID);

QString GetMsgID();
int SetMsgID(QString qsMsgID);

Default Value

""

Remarks

The contents of the Message-ID header field.

This field contains a unique identifier that refers to a particular version of this message.

This property is not available at design time.

Data Type

String

MsgInReplyTo Property (MailWriter Class)

The value of the In-Reply-To header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgInReplyTo();
int SetMsgInReplyTo(const char* lpszMsgInReplyTo);

Unicode (Windows)
LPWSTR GetMsgInReplyTo();
INT SetMsgInReplyTo(LPCWSTR lpszMsgInReplyTo);

char* secureblackbox_mailwriter_getmsginreplyto(void* lpObj);
int secureblackbox_mailwriter_setmsginreplyto(void* lpObj, const char* lpszMsgInReplyTo);

QString GetMsgInReplyTo();
int SetMsgInReplyTo(QString qsMsgInReplyTo);

Default Value

""

Remarks

The value of the In-Reply-To header field.

A reply message should have the "In-Reply-To:" header field which may be used to identify the message (or messages) to which the new message is a reply.

This property is not available at design time.

Data Type

String

MsgKeywords Property (MailWriter Class)

The value of the Keywords header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgKeywords();
int SetMsgKeywords(const char* lpszMsgKeywords);

Unicode (Windows)
LPWSTR GetMsgKeywords();
INT SetMsgKeywords(LPCWSTR lpszMsgKeywords);

char* secureblackbox_mailwriter_getmsgkeywords(void* lpObj);
int secureblackbox_mailwriter_setmsgkeywords(void* lpObj, const char* lpszMsgKeywords);

QString GetMsgKeywords();
int SetMsgKeywords(QString qsMsgKeywords);

Default Value

""

Remarks

The value of the Keywords header field.

This field can be used to add some important words and phrases that might be useful for the recipient.

This property is not available at design time.

Data Type

String

MsgMailer Property (MailWriter Class)

The name of the software that was used to send the message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgMailer();

Unicode (Windows)
LPWSTR GetMsgMailer();

char* secureblackbox_mailwriter_getmsgmailer(void* lpObj);

QString GetMsgMailer();

Default Value

""

Remarks

The name of the software that was used to send the message.

This property is read-only and not available at design time.

Data Type

String

MsgPlainText Property (MailWriter Class)

The plain text version of the message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgPlainText();
int SetMsgPlainText(const char* lpszMsgPlainText);

Unicode (Windows)
LPWSTR GetMsgPlainText();
INT SetMsgPlainText(LPCWSTR lpszMsgPlainText);

char* secureblackbox_mailwriter_getmsgplaintext(void* lpObj);
int secureblackbox_mailwriter_setmsgplaintext(void* lpObj, const char* lpszMsgPlainText);

QString GetMsgPlainText();
int SetMsgPlainText(QString qsMsgPlainText);

Default Value

""

Remarks

The plain text version of the message.

This property is not available at design time.

Data Type

String

MsgPriority Property (MailWriter Class)

Specifies the message priority.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetMsgPriority();
int SetMsgPriority(int iMsgPriority);

Unicode (Windows)
INT GetMsgPriority();
INT SetMsgPriority(INT iMsgPriority);

MP_LOWEST(0), 
MP_LOW(1), 
MP_NORMAL(2), 
MP_HIGH(3), 
MP_HIGHEST(4)

int secureblackbox_mailwriter_getmsgpriority(void* lpObj);
int secureblackbox_mailwriter_setmsgpriority(void* lpObj, int iMsgPriority);

int GetMsgPriority();
int SetMsgPriority(int iMsgPriority);

Default Value

2

Remarks

Specifies the message priority.

Available options:

This property is not available at design time.

Data Type

Integer

MsgReadReceipt Property (MailWriter Class)

Enables a read notification.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetMsgReadReceipt();
int SetMsgReadReceipt(int bMsgReadReceipt);

Unicode (Windows)
BOOL GetMsgReadReceipt();
INT SetMsgReadReceipt(BOOL bMsgReadReceipt);

int secureblackbox_mailwriter_getmsgreadreceipt(void* lpObj);
int secureblackbox_mailwriter_setmsgreadreceipt(void* lpObj, int bMsgReadReceipt);

bool GetMsgReadReceipt();
int SetMsgReadReceipt(bool bMsgReadReceipt);

Default Value

FALSE

Remarks

Enables a read notification.

This property is not available at design time.

Data Type

Boolean

MsgReferences Property (MailWriter Class)

The value of the References header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgReferences();
int SetMsgReferences(const char* lpszMsgReferences);

Unicode (Windows)
LPWSTR GetMsgReferences();
INT SetMsgReferences(LPCWSTR lpszMsgReferences);

char* secureblackbox_mailwriter_getmsgreferences(void* lpObj);
int secureblackbox_mailwriter_setmsgreferences(void* lpObj, const char* lpszMsgReferences);

QString GetMsgReferences();
int SetMsgReferences(QString qsMsgReferences);

Default Value

""

Remarks

The value of the References header field.

A reply message should include a "References:" header field which may be used to identify the "conversation thread". If the initial message is a reply itself, the References of the reply contain combined content of its "References:", "InReplyTo:" and "MessageID:" fields, subject to their presence in the original message.

This property is not available at design time.

Data Type

String

MsgReplyTo Property (MailWriter Class)

The value of the Reply-To header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgReplyTo();
int SetMsgReplyTo(const char* lpszMsgReplyTo);

Unicode (Windows)
LPWSTR GetMsgReplyTo();
INT SetMsgReplyTo(LPCWSTR lpszMsgReplyTo);

char* secureblackbox_mailwriter_getmsgreplyto(void* lpObj);
int secureblackbox_mailwriter_setmsgreplyto(void* lpObj, const char* lpszMsgReplyTo);

QString GetMsgReplyTo();
int SetMsgReplyTo(QString qsMsgReplyTo);

Default Value

""

Remarks

The value of the Reply-To header field.

This field contains the addresses to which the replies to this message should be sent. This field is optional. If not specified, the replies must be sent to the addresses specified in the MsgFrom field.

This property is not available at design time.

Data Type

String

MsgReturnPath Property (MailWriter Class)

The value of the Return-Path header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgReturnPath();
int SetMsgReturnPath(const char* lpszMsgReturnPath);

Unicode (Windows)
LPWSTR GetMsgReturnPath();
INT SetMsgReturnPath(LPCWSTR lpszMsgReturnPath);

char* secureblackbox_mailwriter_getmsgreturnpath(void* lpObj);
int secureblackbox_mailwriter_setmsgreturnpath(void* lpObj, const char* lpszMsgReturnPath);

QString GetMsgReturnPath();
int SetMsgReturnPath(QString qsMsgReturnPath);

Default Value

""

Remarks

The value of the Return-Path header field.

This field contains the address to which this message shall be returned in case of unsuccessful delivery.

This property is not available at design time.

Data Type

String

MsgSender Property (MailWriter Class)

The value of the Sender header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgSender();
int SetMsgSender(const char* lpszMsgSender);

Unicode (Windows)
LPWSTR GetMsgSender();
INT SetMsgSender(LPCWSTR lpszMsgSender);

char* secureblackbox_mailwriter_getmsgsender(void* lpObj);
int secureblackbox_mailwriter_setmsgsender(void* lpObj, const char* lpszMsgSender);

QString GetMsgSender();
int SetMsgSender(QString qsMsgSender);

Default Value

""

Remarks

The value of the Sender header field.

This field specifies the mailbox of the agent responsible for the actual transmission of this message. If the originator of the message can be indicated by a single mailbox and both the author and the transmitter are identical, the "Sender:" field is deemed excessive and should not be used.

This property is not available at design time.

Data Type

String

MsgSendTo Property (MailWriter Class)

The value of the To header property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgSendTo();
int SetMsgSendTo(const char* lpszMsgSendTo);

Unicode (Windows)
LPWSTR GetMsgSendTo();
INT SetMsgSendTo(LPCWSTR lpszMsgSendTo);

char* secureblackbox_mailwriter_getmsgsendto(void* lpObj);
int secureblackbox_mailwriter_setmsgsendto(void* lpObj, const char* lpszMsgSendTo);

QString GetMsgSendTo();
int SetMsgSendTo(QString qsMsgSendTo);

Default Value

""

Remarks

The value of the To header field.

This field specifies the address(es) of the primary recipient(s) of the message.

This property is not available at design time.

Data Type

String

MsgSubject Property (MailWriter Class)

Contains the subject property of this message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMsgSubject();
int SetMsgSubject(const char* lpszMsgSubject);

Unicode (Windows)
LPWSTR GetMsgSubject();
INT SetMsgSubject(LPCWSTR lpszMsgSubject);

char* secureblackbox_mailwriter_getmsgsubject(void* lpObj);
int secureblackbox_mailwriter_setmsgsubject(void* lpObj, const char* lpszMsgSubject);

QString GetMsgSubject();
int SetMsgSubject(QString qsMsgSubject);

Default Value

""

Remarks

Contains the subject field of this message.

This property is not available at design time.

Data Type

String

HeaderFieldCount Property (MailWriter Class)

The number of records in the HeaderField arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetHeaderFieldCount();
int SetHeaderFieldCount(int iHeaderFieldCount);

Unicode (Windows)
INT GetHeaderFieldCount();
INT SetHeaderFieldCount(INT iHeaderFieldCount);

int secureblackbox_mailwriter_getheaderfieldcount(void* lpObj);
int secureblackbox_mailwriter_setheaderfieldcount(void* lpObj, int iHeaderFieldCount);

int GetHeaderFieldCount();
int SetHeaderFieldCount(int iHeaderFieldCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• HeaderFieldCategory
• HeaderFieldFormat
• HeaderFieldName
• HeaderFieldValue

The array indices start at 0 and end at HeaderFieldCount - 1.

This property is not available at design time.

Data Type

Integer

HeaderFieldCategory Property (MailWriter Class)

Specifies the string category of the contained value.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetHeaderFieldCategory(int iHeaderFieldIndex);
int SetHeaderFieldCategory(int iHeaderFieldIndex, const char* lpszHeaderFieldCategory);

Unicode (Windows)
LPWSTR GetHeaderFieldCategory(INT iHeaderFieldIndex);
INT SetHeaderFieldCategory(INT iHeaderFieldIndex, LPCWSTR lpszHeaderFieldCategory);

char* secureblackbox_mailwriter_getheaderfieldcategory(void* lpObj, int headerfieldindex);
int secureblackbox_mailwriter_setheaderfieldcategory(void* lpObj, int headerfieldindex, const char* lpszHeaderFieldCategory);

QString GetHeaderFieldCategory(int iHeaderFieldIndex);
int SetHeaderFieldCategory(int iHeaderFieldIndex, QString qsHeaderFieldCategory);

Default Value

""

Remarks

Specifies the string category of the contained value.

This property allows to check or set the category (or type) associated with the contained value. Depending on the format used to load or save the string, the category parameter may or may not be used.

For example, for ASN.1 property lists the category contains the ASN.1 tag of the contained data (OCTETSTRING, UTF8STRING, INTEGER, ...). For basic (name, value) pairs, such as HTTP headers, the category parameter is not used.

The HeaderFieldIndex parameter specifies the index of the item in the array. The size of the array is controlled by the HeaderFieldCount property.

This property is not available at design time.

Data Type

String

HeaderFieldFormat Property (MailWriter Class)

Specifies the format (encoding) of the value contained in the Value property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetHeaderFieldFormat(int iHeaderFieldIndex);
int SetHeaderFieldFormat(int iHeaderFieldIndex, int iHeaderFieldFormat);

Unicode (Windows)
INT GetHeaderFieldFormat(INT iHeaderFieldIndex);
INT SetHeaderFieldFormat(INT iHeaderFieldIndex, INT iHeaderFieldFormat);

int secureblackbox_mailwriter_getheaderfieldformat(void* lpObj, int headerfieldindex);
int secureblackbox_mailwriter_setheaderfieldformat(void* lpObj, int headerfieldindex, int iHeaderFieldFormat);

int GetHeaderFieldFormat(int iHeaderFieldIndex);
int SetHeaderFieldFormat(int iHeaderFieldIndex, int iHeaderFieldFormat);

Default Value

0

Remarks

Specifies the format (encoding) of the value contained in the HeaderFieldValue property.

Use this property to check or set the format of the contained value. Remember to provide the actual value in the appropriate format that matches this setting:

 
 Copy
  utils.NameValuePairs[0].Name = "key";
  utils.NameValuePairs[0].Format = svfBinary;
  utils.NameValuePairs[0].Name = "0a1b2c3d4e5f6071";

The following formats are currently supported:

The HeaderFieldIndex parameter specifies the index of the item in the array. The size of the array is controlled by the HeaderFieldCount property.

This property is not available at design time.

Data Type

Integer

HeaderFieldName Property (MailWriter Class)

The name element in a (name, value) pair.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetHeaderFieldName(int iHeaderFieldIndex);
int SetHeaderFieldName(int iHeaderFieldIndex, const char* lpszHeaderFieldName);

Unicode (Windows)
LPWSTR GetHeaderFieldName(INT iHeaderFieldIndex);
INT SetHeaderFieldName(INT iHeaderFieldIndex, LPCWSTR lpszHeaderFieldName);

char* secureblackbox_mailwriter_getheaderfieldname(void* lpObj, int headerfieldindex);
int secureblackbox_mailwriter_setheaderfieldname(void* lpObj, int headerfieldindex, const char* lpszHeaderFieldName);

QString GetHeaderFieldName(int iHeaderFieldIndex);
int SetHeaderFieldName(int iHeaderFieldIndex, QString qsHeaderFieldName);

Default Value

""

Remarks

The name element in a (name, value) pair.

The HeaderFieldIndex parameter specifies the index of the item in the array. The size of the array is controlled by the HeaderFieldCount property.

This property is not available at design time.

Data Type

String

HeaderFieldValue Property (MailWriter Class)

The value element in a (name, value) pair.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetHeaderFieldValue(int iHeaderFieldIndex);
int SetHeaderFieldValue(int iHeaderFieldIndex, const char* lpszHeaderFieldValue);

Unicode (Windows)
LPWSTR GetHeaderFieldValue(INT iHeaderFieldIndex);
INT SetHeaderFieldValue(INT iHeaderFieldIndex, LPCWSTR lpszHeaderFieldValue);

char* secureblackbox_mailwriter_getheaderfieldvalue(void* lpObj, int headerfieldindex);
int secureblackbox_mailwriter_setheaderfieldvalue(void* lpObj, int headerfieldindex, const char* lpszHeaderFieldValue);

QString GetHeaderFieldValue(int iHeaderFieldIndex);
int SetHeaderFieldValue(int iHeaderFieldIndex, QString qsHeaderFieldValue);

Default Value

""

Remarks

The value element in a (name, value) pair.

The HeaderFieldIndex parameter specifies the index of the item in the array. The size of the array is controlled by the HeaderFieldCount property.

This property is not available at design time.

Data Type

String

Profile Property (MailWriter Class)

Specifies a pre-defined profile to apply when creating the signature.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetProfile();
int SetProfile(const char* lpszProfile);

Unicode (Windows)
LPWSTR GetProfile();
INT SetProfile(LPCWSTR lpszProfile);

char* secureblackbox_mailwriter_getprofile(void* lpObj);
int secureblackbox_mailwriter_setprofile(void* lpObj, const char* lpszProfile);

QString GetProfile();
int SetProfile(QString qsProfile);

Default Value

""

Remarks

Advanced signatures come in many variants, which are often defined by parties that needs to process them or by local standards. SecureBlackbox profiles are sets of pre-defined configurations which correspond to particular signature variants. By specifying a profile, you are pre-configuring the component to make it produce the signature that matches the configuration corresponding to that profile.

Data Type

String

ReplyToAddrCount Property (MailWriter Class)

The number of records in the ReplyToAddr arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetReplyToAddrCount();
int SetReplyToAddrCount(int iReplyToAddrCount);

Unicode (Windows)
INT GetReplyToAddrCount();
INT SetReplyToAddrCount(INT iReplyToAddrCount);

int secureblackbox_mailwriter_getreplytoaddrcount(void* lpObj);
int secureblackbox_mailwriter_setreplytoaddrcount(void* lpObj, int iReplyToAddrCount);

int GetReplyToAddrCount();
int SetReplyToAddrCount(int iReplyToAddrCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• ReplyToAddrAddress
• ReplyToAddrDisplayName
• ReplyToAddrGroupName

The array indices start at 0 and end at ReplyToAddrCount - 1.

This property is not available at design time.

Data Type

Integer

ReplyToAddrAddress Property (MailWriter Class)

Contains the e-mail address in the form of john@doe.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetReplyToAddrAddress(int iReplyToAddrIndex);
int SetReplyToAddrAddress(int iReplyToAddrIndex, const char* lpszReplyToAddrAddress);

Unicode (Windows)
LPWSTR GetReplyToAddrAddress(INT iReplyToAddrIndex);
INT SetReplyToAddrAddress(INT iReplyToAddrIndex, LPCWSTR lpszReplyToAddrAddress);

char* secureblackbox_mailwriter_getreplytoaddraddress(void* lpObj, int replytoaddrindex);
int secureblackbox_mailwriter_setreplytoaddraddress(void* lpObj, int replytoaddrindex, const char* lpszReplyToAddrAddress);

QString GetReplyToAddrAddress(int iReplyToAddrIndex);
int SetReplyToAddrAddress(int iReplyToAddrIndex, QString qsReplyToAddrAddress);

Default Value

""

Remarks

Contains the e-mail address in the form of john@doe.com.

The ReplyToAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReplyToAddrCount property.

This property is not available at design time.

Data Type

String

ReplyToAddrDisplayName Property (MailWriter Class)

Contains the friendly name of the user of this address, such as John Doe.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetReplyToAddrDisplayName(int iReplyToAddrIndex);
int SetReplyToAddrDisplayName(int iReplyToAddrIndex, const char* lpszReplyToAddrDisplayName);

Unicode (Windows)
LPWSTR GetReplyToAddrDisplayName(INT iReplyToAddrIndex);
INT SetReplyToAddrDisplayName(INT iReplyToAddrIndex, LPCWSTR lpszReplyToAddrDisplayName);

char* secureblackbox_mailwriter_getreplytoaddrdisplayname(void* lpObj, int replytoaddrindex);
int secureblackbox_mailwriter_setreplytoaddrdisplayname(void* lpObj, int replytoaddrindex, const char* lpszReplyToAddrDisplayName);

QString GetReplyToAddrDisplayName(int iReplyToAddrIndex);
int SetReplyToAddrDisplayName(int iReplyToAddrIndex, QString qsReplyToAddrDisplayName);

Default Value

""

Remarks

Contains the friendly name of the user of this address, such as John Doe.

The ReplyToAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReplyToAddrCount property.

This property is not available at design time.

Data Type

String

ReplyToAddrGroupName Property (MailWriter Class)

The name of the group this address belongs to.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetReplyToAddrGroupName(int iReplyToAddrIndex);
int SetReplyToAddrGroupName(int iReplyToAddrIndex, const char* lpszReplyToAddrGroupName);

Unicode (Windows)
LPWSTR GetReplyToAddrGroupName(INT iReplyToAddrIndex);
INT SetReplyToAddrGroupName(INT iReplyToAddrIndex, LPCWSTR lpszReplyToAddrGroupName);

char* secureblackbox_mailwriter_getreplytoaddrgroupname(void* lpObj, int replytoaddrindex);
int secureblackbox_mailwriter_setreplytoaddrgroupname(void* lpObj, int replytoaddrindex, const char* lpszReplyToAddrGroupName);

QString GetReplyToAddrGroupName(int iReplyToAddrIndex);
int SetReplyToAddrGroupName(int iReplyToAddrIndex, QString qsReplyToAddrGroupName);

Default Value

""

Remarks

The name of the group this address belongs to.

The ReplyToAddrIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReplyToAddrCount property.

This property is not available at design time.

Data Type

String

SecSettingsClaimedSigningTime Property (MailWriter Class)

Specifies the signing time from the signer's computer.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetSecSettingsClaimedSigningTime();
int SetSecSettingsClaimedSigningTime(const char* lpszSecSettingsClaimedSigningTime);

Unicode (Windows)
LPWSTR GetSecSettingsClaimedSigningTime();
INT SetSecSettingsClaimedSigningTime(LPCWSTR lpszSecSettingsClaimedSigningTime);

char* secureblackbox_mailwriter_getsecsettingsclaimedsigningtime(void* lpObj);
int secureblackbox_mailwriter_setsecsettingsclaimedsigningtime(void* lpObj, const char* lpszSecSettingsClaimedSigningTime);

QString GetSecSettingsClaimedSigningTime();
int SetSecSettingsClaimedSigningTime(QString qsSecSettingsClaimedSigningTime);

Default Value

""

Remarks

Specifies the signing time from the signer's computer.

Use this property to specify the signature production time. The claimed time is not covered by the signature, may be forfeited or wrong, and as such is usually taken by verifiers for informational purposes only.

Data Type

String

SecSettingsEncrypt Property (MailWriter Class)

Whether to encrypt the message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetSecSettingsEncrypt();
int SetSecSettingsEncrypt(int bSecSettingsEncrypt);

Unicode (Windows)
BOOL GetSecSettingsEncrypt();
INT SetSecSettingsEncrypt(BOOL bSecSettingsEncrypt);

int secureblackbox_mailwriter_getsecsettingsencrypt(void* lpObj);
int secureblackbox_mailwriter_setsecsettingsencrypt(void* lpObj, int bSecSettingsEncrypt);

bool GetSecSettingsEncrypt();
int SetSecSettingsEncrypt(bool bSecSettingsEncrypt);

Default Value

FALSE

Remarks

Whether to encrypt the message.

Data Type

Boolean

SecSettingsEncryptionAlgorithm Property (MailWriter Class)

Specifies the encryption algorithm to be used.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetSecSettingsEncryptionAlgorithm();
int SetSecSettingsEncryptionAlgorithm(const char* lpszSecSettingsEncryptionAlgorithm);

Unicode (Windows)
LPWSTR GetSecSettingsEncryptionAlgorithm();
INT SetSecSettingsEncryptionAlgorithm(LPCWSTR lpszSecSettingsEncryptionAlgorithm);

char* secureblackbox_mailwriter_getsecsettingsencryptionalgorithm(void* lpObj);
int secureblackbox_mailwriter_setsecsettingsencryptionalgorithm(void* lpObj, const char* lpszSecSettingsEncryptionAlgorithm);

QString GetSecSettingsEncryptionAlgorithm();
int SetSecSettingsEncryptionAlgorithm(QString qsSecSettingsEncryptionAlgorithm);

Default Value

"AES128"

Remarks

Specifies the encryption algorithm to be used.

Data Type

String

SecSettingsHashAlgorithm Property (MailWriter Class)

Specifies the hash algorithm to be used.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetSecSettingsHashAlgorithm();
int SetSecSettingsHashAlgorithm(const char* lpszSecSettingsHashAlgorithm);

Unicode (Windows)
LPWSTR GetSecSettingsHashAlgorithm();
INT SetSecSettingsHashAlgorithm(LPCWSTR lpszSecSettingsHashAlgorithm);

char* secureblackbox_mailwriter_getsecsettingshashalgorithm(void* lpObj);
int secureblackbox_mailwriter_setsecsettingshashalgorithm(void* lpObj, const char* lpszSecSettingsHashAlgorithm);

QString GetSecSettingsHashAlgorithm();
int SetSecSettingsHashAlgorithm(QString qsSecSettingsHashAlgorithm);

Default Value

"SHA256"

Remarks

Specifies the hash algorithm to be used.

Data Type

String

SecSettingsSign Property (MailWriter Class)

Whether to sign the message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetSecSettingsSign();
int SetSecSettingsSign(int bSecSettingsSign);

Unicode (Windows)
BOOL GetSecSettingsSign();
INT SetSecSettingsSign(BOOL bSecSettingsSign);

int secureblackbox_mailwriter_getsecsettingssign(void* lpObj);
int secureblackbox_mailwriter_setsecsettingssign(void* lpObj, int bSecSettingsSign);

bool GetSecSettingsSign();
int SetSecSettingsSign(bool bSecSettingsSign);

Default Value

FALSE

Remarks

Whether to sign the message.

Data Type

Boolean

SecSettingsSignatureFormat Property (MailWriter Class)

Specifies the signature format to use for the signed message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetSecSettingsSignatureFormat();
int SetSecSettingsSignatureFormat(int iSecSettingsSignatureFormat);

Unicode (Windows)
INT GetSecSettingsSignatureFormat();
INT SetSecSettingsSignatureFormat(INT iSecSettingsSignatureFormat);

MS_MULTIPART_SIGNED(0), 
MS_SIGNED_DATA(1)

int secureblackbox_mailwriter_getsecsettingssignatureformat(void* lpObj);
int secureblackbox_mailwriter_setsecsettingssignatureformat(void* lpObj, int iSecSettingsSignatureFormat);

int GetSecSettingsSignatureFormat();
int SetSecSettingsSignatureFormat(int iSecSettingsSignatureFormat);

Default Value

0

Remarks

Specifies the signature format to use for the signed message.

Available options:

Data Type

Integer

SecSettingsSignBeforeEncrypt Property (MailWriter Class)

Specifies the order of encryption and signing operations.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetSecSettingsSignBeforeEncrypt();
int SetSecSettingsSignBeforeEncrypt(int bSecSettingsSignBeforeEncrypt);

Unicode (Windows)
BOOL GetSecSettingsSignBeforeEncrypt();
INT SetSecSettingsSignBeforeEncrypt(BOOL bSecSettingsSignBeforeEncrypt);

int secureblackbox_mailwriter_getsecsettingssignbeforeencrypt(void* lpObj);
int secureblackbox_mailwriter_setsecsettingssignbeforeencrypt(void* lpObj, int bSecSettingsSignBeforeEncrypt);

bool GetSecSettingsSignBeforeEncrypt();
int SetSecSettingsSignBeforeEncrypt(bool bSecSettingsSignBeforeEncrypt);

Default Value

TRUE

Remarks

Specifies the order of encryption and signing operations.

Data Type

Boolean

SecSettingsSignMessageHeader Property (MailWriter Class)

Specifies whether to include the message header in the signature calculation.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetSecSettingsSignMessageHeader();
int SetSecSettingsSignMessageHeader(int bSecSettingsSignMessageHeader);

Unicode (Windows)
BOOL GetSecSettingsSignMessageHeader();
INT SetSecSettingsSignMessageHeader(BOOL bSecSettingsSignMessageHeader);

int secureblackbox_mailwriter_getsecsettingssignmessageheader(void* lpObj);
int secureblackbox_mailwriter_setsecsettingssignmessageheader(void* lpObj, int bSecSettingsSignMessageHeader);

bool GetSecSettingsSignMessageHeader();
int SetSecSettingsSignMessageHeader(bool bSecSettingsSignMessageHeader);

Default Value

FALSE

Remarks

Specifies whether to include the message header in the signature calculation.

Data Type

Boolean

SenderAddrAddress Property (MailWriter Class)

Contains the e-mail address in the form of john@doe.

Syntax