KeyMgr Class

Properties   Methods   Events   Config Settings   Errors  

The KeyMgr class is used to create and manage OpenPGP keys.

Syntax

KeyMgr

Remarks

The KeyMgr class can be used to perform a variety of key-related actions. You can create, delete, import, export, and manage keys. Both individual keys and keyrings can be created and used.

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.

KeyCurve Property (KeyMgr Class)

This property specifies the elliptic curve used in the ECDSA or EdDSA key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyCurve();

Unicode (Windows)
LPWSTR GetKeyCurve();

char* ipworksopenpgp_keymgr_getkeycurve(void* lpObj);

QString GetKeyCurve();

Default Value

""

Remarks

This property specifies the elliptic curve used in the ECDSA or EdDSA key. This property is only applicable if KeyPublicKeyAlgorithm is ECDSA or EdDSA. Possible values are:

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

Data Type

String

KeyEffectiveDate Property (KeyMgr Class)

The date when this key becomes valid.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyEffectiveDate();

Unicode (Windows)
LPWSTR GetKeyEffectiveDate();

char* ipworksopenpgp_keymgr_getkeyeffectivedate(void* lpObj);

QString GetKeyEffectiveDate();

Default Value

""

Remarks

The date when this key becomes valid. Prior to this it is not valid. The following is an example of a valid encoded date:

23-Jan-2000 15:00:00.

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

Data Type

String

KeyEncoded Property (KeyMgr Class)

The key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKeyEncoded(char* &lpKeyEncoded, int &lenKeyEncoded);
int SetKeyEncoded(const char* lpKeyEncoded, int lenKeyEncoded);

Unicode (Windows)
INT GetKeyEncoded(LPSTR &lpKeyEncoded, INT &lenKeyEncoded);
INT SetKeyEncoded(LPCSTR lpKeyEncoded, INT lenKeyEncoded);

int ipworksopenpgp_keymgr_getkeyencoded(void* lpObj, char** lpKeyEncoded, int* lenKeyEncoded);
int ipworksopenpgp_keymgr_setkeyencoded(void* lpObj, const char* lpKeyEncoded, int lenKeyEncoded);

QByteArray GetKeyEncoded();
int SetKeyEncoded(QByteArray qbaKeyEncoded);

Default Value

""

Remarks

The key. This property is used to assign a specific key. The KeyUserId properties may also be used to specify a key.

This property is not available at design time.

Data Type

Binary String

KeyExpirationDate Property (KeyMgr Class)

The date the key expires.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyExpirationDate();

Unicode (Windows)
LPWSTR GetKeyExpirationDate();

char* ipworksopenpgp_keymgr_getkeyexpirationdate(void* lpObj);

QString GetKeyExpirationDate();

Default Value

""

Remarks

The date the key expires. After this date the key will no longer be valid. The following is an example of a valid encoded date:

23-Jan-2001 15:00:00.

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

Data Type

String

KeyFingerprint Property (KeyMgr Class)

The hex-encoded, 20-byte fingerprint of the key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyFingerprint();

Unicode (Windows)
LPWSTR GetKeyFingerprint();

char* ipworksopenpgp_keymgr_getkeyfingerprint(void* lpObj);

QString GetKeyFingerprint();

Default Value

""

Remarks

The hex-encoded, 20-byte fingerprint of the key.

This is in the form:

5E70662EA810E768391A2FE8F7B7D49C89C9D7B1

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

Data Type

String

KeyId Property (KeyMgr Class)

The hex-encoded, 4-byte key Id.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyId();

Unicode (Windows)
LPWSTR GetKeyId();

char* ipworksopenpgp_keymgr_getkeyid(void* lpObj);

QString GetKeyId();

Default Value

""

Remarks

The hex-encoded, 4-byte key Id. It is same as last 4 bytes of KeyFingerprint.

This is in the form:

89C9D7B1

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

Data Type

String

KeyOtherUserIds Property (KeyMgr Class)

If the specified key has alternate user Ids associated with it, this property returns a comma-separated list of the other user Ids.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyOtherUserIds();

Unicode (Windows)
LPWSTR GetKeyOtherUserIds();

char* ipworksopenpgp_keymgr_getkeyotheruserids(void* lpObj);

QString GetKeyOtherUserIds();

Default Value

""

Remarks

If the specified key has alternate user Ids associated with it, this property returns a comma-separated list of the other user Ids.

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

Data Type

String

KeyPassphrase Property (KeyMgr Class)

The passphrase for the key's secret key (if any).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyPassphrase();
int SetKeyPassphrase(const char* lpszKeyPassphrase);

Unicode (Windows)
LPWSTR GetKeyPassphrase();
INT SetKeyPassphrase(LPCWSTR lpszKeyPassphrase);

char* ipworksopenpgp_keymgr_getkeypassphrase(void* lpObj);
int ipworksopenpgp_keymgr_setkeypassphrase(void* lpObj, const char* lpszKeyPassphrase);

QString GetKeyPassphrase();
int SetKeyPassphrase(QString qsKeyPassphrase);

Default Value

""

Remarks

The passphrase for the key's secret key (if any). This must be specified before operations requiring the secret key are attempted. The passphrase may be supplied in this property or through the KeyPassphrase event, which will fire when a passphrase is required.

The passphrase is required when using the following methods in KeyMgr:

• AddUserId
• SignUserId
• ChangeExpirationDate
• ChangePassphrase

When using the OpenPGP class, or an email-based class, the following methods require a passphrase for the key:

• Decrypt
• Sign
• SignAndEncrypt

This property is not available at design time.

Data Type

String

KeyPublicKey Property (KeyMgr Class)

The public key of the key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyPublicKey();

Unicode (Windows)
LPWSTR GetKeyPublicKey();

char* ipworksopenpgp_keymgr_getkeypublickey(void* lpObj);

QString GetKeyPublicKey();

Default Value

""

Remarks

The public key of the key. The key is provided as ASCII armored data.

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

Data Type

String

KeyPublicKeyAlgorithm Property (KeyMgr Class)

A text description of the public key algorithm of the key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyPublicKeyAlgorithm();

Unicode (Windows)
LPWSTR GetKeyPublicKeyAlgorithm();

char* ipworksopenpgp_keymgr_getkeypublickeyalgorithm(void* lpObj);

QString GetKeyPublicKeyAlgorithm();

Default Value

""

Remarks

A text description of the public key algorithm of the key. Possible values are:

• RSA
• DSA
• ECDSA
• EdDSA
• RSA-Legacy

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

Data Type

String

KeyPublicKeyLength Property (KeyMgr Class)

The length of the public key in bits.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKeyPublicKeyLength();

Unicode (Windows)
INT GetKeyPublicKeyLength();

int ipworksopenpgp_keymgr_getkeypublickeylength(void* lpObj);

int GetKeyPublicKeyLength();

Default Value

0

Remarks

The length of the public key in bits. Common values are 512, 1024, and 2048.

If the KeyPublicKeyAlgorithm property is ECDSA or EcDSA the length of the public key is determined by the KeyCurve. Possible lenghts are:

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

Data Type

Integer

KeyRevoked Property (KeyMgr Class)

Whether or not the key is revoked.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKeyRevoked();

Unicode (Windows)
BOOL GetKeyRevoked();

int ipworksopenpgp_keymgr_getkeyrevoked(void* lpObj);

bool GetKeyRevoked();

Default Value

FALSE

Remarks

Whether or not the key is revoked.

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

Data Type

Boolean

KeySecretKey Property (KeyMgr Class)

The secret key of the key (if available).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeySecretKey();

Unicode (Windows)
LPWSTR GetKeySecretKey();

char* ipworksopenpgp_keymgr_getkeysecretkey(void* lpObj);

QString GetKeySecretKey();

Default Value

""

Remarks

The secret key of the key (if available). The key is provided as ASCII armored data.

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

Data Type

String

KeySecretKeyAvailable Property (KeyMgr Class)

Whether or not a secret key is available for the selected key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKeySecretKeyAvailable();

Unicode (Windows)
BOOL GetKeySecretKeyAvailable();

int ipworksopenpgp_keymgr_getkeysecretkeyavailable(void* lpObj);

bool GetKeySecretKeyAvailable();

Default Value

FALSE

Remarks

Whether or not a secret key is available for the selected key.

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

Data Type

Boolean

KeyUsage Property (KeyMgr Class)

A text description of UsageFlags .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyUsage();

Unicode (Windows)
LPWSTR GetKeyUsage();

char* ipworksopenpgp_keymgr_getkeyusage(void* lpObj);

QString GetKeyUsage();

Default Value

""

Remarks

A text description of KeyUsageFlags.

The value will be of one or more of the following strings, separated by commas:

• Certifying Other Certificates
• Signing Emails and Files
• Encrypting Emails and Files
• Split Key
• Authenticate Against Servers
• Group Key

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

Data Type

String

KeyUsageFlags Property (KeyMgr Class)

Flags that show the intended use for the key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKeyUsageFlags();

Unicode (Windows)
INT GetKeyUsageFlags();

int ipworksopenpgp_keymgr_getkeyusageflags(void* lpObj);

int GetKeyUsageFlags();

Default Value

47

Remarks

Flags that show the intended use for the key. The default value is 0x0F. The value of KeyUsageFlags is a combination of the following flags:

Please refer to the KeyUsage property for a text representation of KeyUsageFlags.

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

Data Type

Integer

KeyUserId Property (KeyMgr Class)

The user Id of the key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyUserId();
int SetKeyUserId(const char* lpszKeyUserId);

Unicode (Windows)
LPWSTR GetKeyUserId();
INT SetKeyUserId(LPCWSTR lpszKeyUserId);

char* ipworksopenpgp_keymgr_getkeyuserid(void* lpObj);
int ipworksopenpgp_keymgr_setkeyuserid(void* lpObj, const char* lpszKeyUserId);

QString GetKeyUserId();
int SetKeyUserId(QString qsKeyUserId);

Default Value

""

Remarks

The user Id of the key. When a key is loaded this property is populated with the user Id associated with the key. This property may be set to load a key from the Keyring. When this property is set the class will search the Keyring for a key associated with the UserId specified.

When loading a key with multiple user Ids, this property will be populated with the UserId that was most recently added to the key. To discover all of the UserIds associated with a key query this property and KeyOtherUserIds after loading the key.

The UserId format is:

FirstName LastName (Comment) <Email>

When using this property to select a key you may also specify the key's Id, or any of its subkeys' Ids, instead of a user Id. The class will then search for a key with a matching Id. This is helpful in situations where you do not have the UserId but still need to load the key, such as within the OpenPGP class's RecipientInfo event.

This property is not available at design time.

Data Type

String

Keyring Property (KeyMgr Class)

The location on disk of the keyring.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetKeyring();

Unicode (Windows)
LPWSTR GetKeyring();

char* ipworksopenpgp_keymgr_getkeyring(void* lpObj);

QString GetKeyring();

Default Value

""

Remarks

To load a keyring use the LoadKeyring method.

This property is read-only.

Data Type

String

AddRevoker Method (KeyMgr Class)

Adds a designated revoker to the key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int AddRevoker(const char* lpszUserId);

Unicode (Windows)
INT AddRevoker(LPCWSTR lpszUserId);

int ipworksopenpgp_keymgr_addrevoker(void* lpObj, const char* lpszUserId);

int AddRevoker(const QString& qsUserId);

Remarks

This method adds a designated revoker to the selected Key. The UserId parameter specifies the revoker to add. The revoker's key must be present in the current keyring. Use this with caution: once added, a revoker cannot be removed. The key's passphrase is required for this operation and may be specified via KeyPassphrase or through the KeyPassphrase event.

The UserId format is:

FirstName LastName (Comment) <Email>

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

AddUserId Method (KeyMgr Class)

Adds the specified user Id to the current key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int AddUserId(const char* lpszUserId);

Unicode (Windows)
INT AddUserId(LPCWSTR lpszUserId);

int ipworksopenpgp_keymgr_adduserid(void* lpObj, const char* lpszUserId);

int AddUserId(const QString& qsUserId);

Remarks

The key's passphrase is required for this operation and may be specified via KeyPassphrase or through the KeyPassphrase event.

The UserId format is:

FirstName LastName (Comment) <Email>

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ChangeExpirationDate Method (KeyMgr Class)

Changes the expiration date of the key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ChangeExpirationDate(int iExpirationDate);

Unicode (Windows)
INT ChangeExpirationDate(INT iExpirationDate);

int ipworksopenpgp_keymgr_changeexpirationdate(void* lpObj, int iExpirationDate);

int ChangeExpirationDate(int iExpirationDate);

Remarks

This method changes the expiration date of the current Key. The ExpirationDate parameter specifies the number of days for which the key is valid starting today. For instance a value of "31" means the key is valid for the next 31 days.

The special value "0" means the key will never expire.

The key's passphrase is required for this operation and may be specified via KeyPassphrase or through the KeyPassphrase event.

Note: See KeyValidityTime for information on specifying the expiration date when creating the key with CreateKey.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ChangePassphrase Method (KeyMgr Class)

Changes the passphrase of the current key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ChangePassphrase(const char* lpszPassphrase);

Unicode (Windows)
INT ChangePassphrase(LPCWSTR lpszPassphrase);

int ipworksopenpgp_keymgr_changepassphrase(void* lpObj, const char* lpszPassphrase);

int ChangePassphrase(const QString& qsPassphrase);

Remarks

The Passphrase parameter specifies the new passphrase.

The key's passphrase is required for this operation and may be specified via KeyPassphrase or through the KeyPassphrase event.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Config Method (KeyMgr Class)

Sets or retrieves a configuration setting.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* Config(const char* lpszConfigurationString);

Unicode (Windows)
LPWSTR Config(LPCWSTR lpszConfigurationString);

char* ipworksopenpgp_keymgr_config(void* lpObj, const char* lpszConfigurationString);

QString Config(const QString& qsConfigurationString);

Remarks

Config is a generic method available in every class. It is used to set and retrieve configuration settings for the class.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the class, access to these internal properties is provided through the Config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

CreateKey Method (KeyMgr Class)

Creates an OpenPGP key pair.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int CreateKey(const char* lpszUserId, const char* lpszPassphrase);

Unicode (Windows)
INT CreateKey(LPCWSTR lpszUserId, LPCWSTR lpszPassphrase);

int ipworksopenpgp_keymgr_createkey(void* lpObj, const char* lpszUserId, const char* lpszPassphrase);

int CreateKey(const QString& qsUserId, const QString& qsPassphrase);

Remarks

This method creates a new OpenPGP key pair. The UserId parameter specifies the user Id of the key.

The UserId format is:

FirstName LastName (Comment) <Email>

Additional configuration settings may be set to further configure the details of the key being created. Please see the following settings for details:

• KeyEncryptionAlgorithm
• KeyUsage
• KeyValidityTime
• PublicKeyLength
• PublicKeyAlgorithm
• PublicKeySignatureHashAlgorithm
• Curve
• SubKeyCurve

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

CreateSubKey Method (KeyMgr Class)

Creates a new subkey.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int CreateSubKey();

Unicode (Windows)
INT CreateSubKey();

int ipworksopenpgp_keymgr_createsubkey(void* lpObj);

int CreateSubKey();

Remarks

This method creates a new subkey. Before calling this method the KeyId property must be set to a valid private key.

The following settings may optionally be set to define specific values for the created subkey:

• KeyValidityTime
• PublicKeyLength
• SubKeyAlgorithm
• SubKeyCurve
• SubKeyUsage

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

DeleteKey Method (KeyMgr Class)

Deletes the specified key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int DeleteKey(const char* lpszUserId);

Unicode (Windows)
INT DeleteKey(LPCWSTR lpszUserId);

int ipworksopenpgp_keymgr_deletekey(void* lpObj, const char* lpszUserId);

int DeleteKey(const QString& qsUserId);

Remarks

This method deletes the key specified by UserId from the current keyring. Below is a table of the type of Ids that may be specified to identify the key:

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ExportPublicKey Method (KeyMgr Class)

Exports the public key of the current key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ExportPublicKey(const char* lpszFileName, int buseAsciiArmor);

Unicode (Windows)
INT ExportPublicKey(LPCWSTR lpszFileName, BOOL buseAsciiArmor);

int ipworksopenpgp_keymgr_exportpublickey(void* lpObj, const char* lpszFileName, int buseAsciiArmor);

int ExportPublicKey(const QString& qsFileName, bool buseAsciiArmor);

Remarks

This method exports the public key of the currently selected Key. The FileName parameter specifies the file on disk to which the public key will be written. The UseAsciiArmor parameter determines whether or not ASCII armoring is used when writing the key to disk.

Note: When UseAsciiArmor is set to True the VersionHeader setting may also be set to specify your own header value.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ExportSecretKey Method (KeyMgr Class)

Exports the private key of the current key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ExportSecretKey(const char* lpszFileName, int buseAsciiArmor);

Unicode (Windows)
INT ExportSecretKey(LPCWSTR lpszFileName, BOOL buseAsciiArmor);

int ipworksopenpgp_keymgr_exportsecretkey(void* lpObj, const char* lpszFileName, int buseAsciiArmor);

int ExportSecretKey(const QString& qsFileName, bool buseAsciiArmor);

Remarks

This method exports the private key of the currently selected Key. The FileName parameter specifies the file on disk that the private key will be written to. The UseAsciiArmor parameter determines whether or not ASCII armoring is used when writing the key to disk.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ImportKey Method (KeyMgr Class)

Imports the key specified by UserId to the current keyring.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ImportKey(const char* lpszFileName, const char* lpszUserId);

Unicode (Windows)
INT ImportKey(LPCWSTR lpszFileName, LPCWSTR lpszUserId);

int ipworksopenpgp_keymgr_importkey(void* lpObj, const char* lpszFileName, const char* lpszUserId);

int ImportKey(const QString& qsFileName, const QString& qsUserId);

Remarks

This method imports the key specified by UserId from the key file specified by FileName into the current Keyring. The imported key will be automatically selected and available in the Key property.

If the FileName specifies a key file which contains multiple keys only the key belonging to UserId will be imported.

If UserId is set to "*" or "" (empty string) all keys in the key file will be imported. The ImportAllKeys setting controls the behavior of the class in this case.

Note: If you simply wish to select a key in the current ring set KeyUserId instead.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ImportKeyB Method (KeyMgr Class)

Imports the key specified by UserId to the current keyring.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ImportKeyB(const char* lpData, int lenData, const char* lpszUserId);

Unicode (Windows)
INT ImportKeyB(LPCSTR lpData, INT lenData, LPCWSTR lpszUserId);

int ipworksopenpgp_keymgr_importkeyb(void* lpObj, const char* lpData, int lenData, const char* lpszUserId);

int ImportKeyB(QByteArray qbaData, const QString& qsUserId);

Remarks

This method imports the key specified by UserId from the key data specified by Data into the current Keyring. The imported key will be automatically selected and available in the Key property.

If the Data specifies key data that contains multiple keys only the key belonging to UserId will be imported.

If UserId is set to "*" or "" (empty string) all keys in the key data will be imported. The ImportAllKeys setting controls the behavior of the class in this case.

Note: If you simply wish to select a key in the current ring set KeyUserId instead.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ListKeys Method (KeyMgr Class)

Lists keys in the specified Keyring .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* ListKeys();

Unicode (Windows)
LPWSTR ListKeys();

char* ipworksopenpgp_keymgr_listkeys(void* lpObj);

QString ListKeys();

Remarks

This method lists the keys (public/private key pairs) in the specified keyring. The results are provided through the KeyList event.

KeyList data will also be returned from this method, however it is recommended to use the KeyList event if possible.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

ListSignatures Method (KeyMgr Class)

Lists all signatures of the current key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* ListSignatures();

Unicode (Windows)
LPWSTR ListSignatures();

char* ipworksopenpgp_keymgr_listsignatures(void* lpObj);

QString ListSignatures();

Remarks

This method lists all the signatures of the currently selected key. The SignatureList event will fire for each signature.

SignatureList data will also be returned from this method. However, it is recommended to use the SignatureList event if possible.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

ListSubkeys Method (KeyMgr Class)

Lists the subkeys of the currently selected key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* ListSubkeys();

Unicode (Windows)
LPWSTR ListSubkeys();

char* ipworksopenpgp_keymgr_listsubkeys(void* lpObj);

QString ListSubkeys();

Remarks

This method lists all subkeys of current key. The SubkeyList event will be fired for each subkey.

SubkeyList data will also be returned from this method, however it is recommended to use the SubkeyList event if possible.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

LoadKeyring Method (KeyMgr Class)

Loads the keyring from disk.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int LoadKeyring(const char* lpszKeyringPath);

Unicode (Windows)
INT LoadKeyring(LPCWSTR lpszKeyringPath);

int ipworksopenpgp_keymgr_loadkeyring(void* lpObj, const char* lpszKeyringPath);

int LoadKeyring(const QString& qsKeyringPath);

Remarks

This method loads the keyring from disk. If the keyring is stored in a directory, set KeyringPath to the directory. The directory must contain the files "secring.gpg" and "pubring.gpg". A keyring may also be stored in a single file. If the keyring is a file KeyringPath should be set to the path of the file.

When this method is called the class will read the keyring and populate the Key property with the first key found in the keyring. Set KeyUserId to select a different key in the current keyring.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

LoadKeyringB Method (KeyMgr Class)

Loads the keyring from SecretKeyringData and PublicKeyringData .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int LoadKeyringB(const char* lpSecretKeyringData, int lenSecretKeyringData, const char* lpPublicKeyringData, int lenPublicKeyringData);

Unicode (Windows)
INT LoadKeyringB(LPCSTR lpSecretKeyringData, INT lenSecretKeyringData, LPCSTR lpPublicKeyringData, INT lenPublicKeyringData);

int ipworksopenpgp_keymgr_loadkeyringb(void* lpObj, const char* lpSecretKeyringData, int lenSecretKeyringData, const char* lpPublicKeyringData, int lenPublicKeyringData);

int LoadKeyringB(QByteArray qbaSecretKeyringData, QByteArray qbaPublicKeyringData);

Remarks

This method loads the keyring from SecretKeyringData and PublicKeyringData.

When this method is called the class will read the keyring and populate the Key property with the first key found in the keyring. Set KeyUserId to select a different key in the current keyring.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Reset Method (KeyMgr Class)

Resets the class properties.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Reset();

Unicode (Windows)
INT Reset();

int ipworksopenpgp_keymgr_reset(void* lpObj);

int Reset();

Remarks

This method resets all message and key properties to their default values.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

RevokeKey Method (KeyMgr Class)

Revokes the specified key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* RevokeKey(const char* lpszKeyId);

Unicode (Windows)
LPWSTR RevokeKey(LPCWSTR lpszKeyId);

char* ipworksopenpgp_keymgr_revokekey(void* lpObj, const char* lpszKeyId);

QString RevokeKey(const QString& qsKeyId);

Remarks

This method revokes the key specified by KeyId and returns the revocation certificate.

When creating a revocation certificate there are two supported formats. The first format includes only the revocation signature. This format is returned by this method. The second format includes both the public key and the revocation signature. This format can be obtained by calling ExportPublicKey after calling this method. Both formats are common, and both formats are acceptable when calling ImportKey.

Before calling this method a key must be selected and available in the Key* properties.

The KeyId may be the Id of the main key or a subkey.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

SaveKeyring Method (KeyMgr Class)

Saves the current Keyring to disk.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int SaveKeyring(const char* lpszKeyringPath);

Unicode (Windows)
INT SaveKeyring(LPCWSTR lpszKeyringPath);

int ipworksopenpgp_keymgr_savekeyring(void* lpObj, const char* lpszKeyringPath);

int SaveKeyring(const QString& qsKeyringPath);

Remarks

This method saves the current keyring to disk. There are two output options. The keyring may either be saved to a single key file or may be saved to a directory.

To save the keyring to a directory set KeyringPath to the path. The directory must already exist. The class will create a "pubring.gpg" and "secring.gpg" file in the specified directory. If the files already exist they will be overwritten.

To save the keyring to a key file set KeyringPath to a path and file name. If the file already exists it will be overwritten.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

SignUserId Method (KeyMgr Class)

Signs the specified user Id of the current key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int SignUserId(const char* lpszUserId, const char* lpszIssuerUserId);

Unicode (Windows)
INT SignUserId(LPCWSTR lpszUserId, LPCWSTR lpszIssuerUserId);

int ipworksopenpgp_keymgr_signuserid(void* lpObj, const char* lpszUserId, const char* lpszIssuerUserId);

int SignUserId(const QString& qsUserId, const QString& qsIssuerUserId);

Remarks

This method signs the UserId with the IssuerUserId.

To sign all user Ids in the current key set the UserId parameter to "*".

The key's passphrase is required for this operation and may be specified via KeyPassphrase or through the KeyPassphrase event.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

VerifyPassphrase Method (KeyMgr Class)

Verifies the passphrase of specified key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int VerifyPassphrase(const char* lpszPassphrase);

Unicode (Windows)
INT VerifyPassphrase(LPCWSTR lpszPassphrase);

int ipworksopenpgp_keymgr_verifypassphrase(void* lpObj, const char* lpszPassphrase);

bool VerifyPassphrase(const QString& qsPassphrase);

Remarks

This method verifies the passphrase of the key specified by UserId.

If the password is correct, this method returns True; otherwise, this method returns False.

Error Handling (C++)

This method returns a Boolean value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

Error Event (KeyMgr Class)

Information about errors during data delivery.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireError(KeyMgrErrorEventParams *e);

typedef struct {
  int ErrorCode;
  const char *Description;
  int reserved;
} KeyMgrErrorEventParams;


Unicode (Windows)
virtual INT FireError(KeyMgrErrorEventParams *e);

typedef struct {
  INT ErrorCode;
  LPCWSTR Description;
  INT reserved;
} KeyMgrErrorEventParams;

#define EID_KEYMGR_ERROR 1

virtual INT IPWORKSOPENPGP_CALL FireError(INT &iErrorCode, LPSTR &lpszDescription);

class KeyMgrErrorEventParams {
public:
  int ErrorCode();

  const QString &Description();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Error(KeyMgrErrorEventParams *e);

// Or, subclass KeyMgr and override this emitter function.
virtual int FireError(KeyMgrErrorEventParams *e) {...}

Remarks

The Error event is fired in case of exceptional conditions during message processing. Normally the class fails with an error.

The ErrorCode parameter contains an error code, and the Description parameter contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to the Error Codes section.

KeyList Event (KeyMgr Class)

Fires for each key in the keyring when ListKeys is called.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireKeyList(KeyMgrKeyListEventParams *e);

typedef struct {
  const char *UserId;
  const char *KeyId;
  const char *Fingerprint;
  int HasSecretKey;
  const char *PublicKeyAlgorithm;
  int PublicKeyLength;
  const char *Curve;
  int reserved;
} KeyMgrKeyListEventParams;


Unicode (Windows)
virtual INT FireKeyList(KeyMgrKeyListEventParams *e);

typedef struct {
  LPCWSTR UserId;
  LPCWSTR KeyId;
  LPCWSTR Fingerprint;
  BOOL HasSecretKey;
  LPCWSTR PublicKeyAlgorithm;
  INT PublicKeyLength;
  LPCWSTR Curve;
  INT reserved;
} KeyMgrKeyListEventParams;

#define EID_KEYMGR_KEYLIST 2

virtual INT IPWORKSOPENPGP_CALL FireKeyList(LPSTR &lpszUserId, LPSTR &lpszKeyId, LPSTR &lpszFingerprint, BOOL &bHasSecretKey, LPSTR &lpszPublicKeyAlgorithm, INT &iPublicKeyLength, LPSTR &lpszCurve);

class KeyMgrKeyListEventParams {
public:
  const QString &UserId();

  const QString &KeyId();

  const QString &Fingerprint();

  bool HasSecretKey();

  const QString &PublicKeyAlgorithm();

  int PublicKeyLength();

  const QString &Curve();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void KeyList(KeyMgrKeyListEventParams *e);

// Or, subclass KeyMgr and override this emitter function.
virtual int FireKeyList(KeyMgrKeyListEventParams *e) {...}

Remarks

This event fires once for each key in the Keyring when ListKeys is called.

UserId holds the current user Id of the key.

The UserId format is:

FirstName LastName (Comment) <Email>

KeyId is the hex-encoded, 4-byte or 8-byte Id of the key. It is the same as the last 4 or 8 bytes of the Fingerprint. For instance:

BF52A0AB

Fingerprint holds the hex-encoded, 20-byte fingerprint of the key. This is in the form:

5E70662EA810E768391A2FE8F7B7D49C89C9D7B1

HasSecretKey returns True if the key contains a secret key.

PublicKeyAlgorithm is the public key algorithm. Possible values are:

• RSA
• DSA
• ECDSA
• EdDSA

PublicKeyLength is the length of the public key. Common values are 512, 1024, and 2048. If the PublicKeyAlgorithm is ECDSA or EdDSA the length of the public key is determined by the Curve. Possible lengths are:

Curve is the curve used by the key when PublicKeyAlgorithm is ECDSA or EdDSA. Possible values are:

KeyPassphrase Event (KeyMgr Class)

Fired if the passphrase of current key is incorrect or empty.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireKeyPassphrase(KeyMgrKeyPassphraseEventParams *e);

typedef struct {
  const char *UserId;
  const char *KeyId;
  char *Passphrase;
  int reserved;
} KeyMgrKeyPassphraseEventParams;


Unicode (Windows)
virtual INT FireKeyPassphrase(KeyMgrKeyPassphraseEventParams *e);

typedef struct {
  LPCWSTR UserId;
  LPCWSTR KeyId;
  LPWSTR Passphrase;
  INT reserved;
} KeyMgrKeyPassphraseEventParams;

#define EID_KEYMGR_KEYPASSPHRASE 3

virtual INT IPWORKSOPENPGP_CALL FireKeyPassphrase(LPSTR &lpszUserId, LPSTR &lpszKeyId, LPSTR &lpszPassphrase);

class KeyMgrKeyPassphraseEventParams {
public:
  const QString &UserId();

  const QString &KeyId();

  const QString &Passphrase();
  void SetPassphrase(const QString &qsPassphrase);

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void KeyPassphrase(KeyMgrKeyPassphraseEventParams *e);

// Or, subclass KeyMgr and override this emitter function.
virtual int FireKeyPassphrase(KeyMgrKeyPassphraseEventParams *e) {...}

Remarks

This event fires when the passphrase for the key is required. The passphrase must be specified before operations requiring the secret key are attempted. The passphrase may be supplied by setting the Passphrase parameter in this event, or by specifying the KeyPassphrase property before attempting the operation.

The passphrase is required when using the following methods in KeyMgr:

• AddUserId
• SignUserId
• ChangeExpirationDate
• ChangePassphrase

When using the OpenPGP class, or an email-based class, the following methods require a passphrase for the key:

• Decrypt
• Sign
• SignAndEncrypt

SignatureList Event (KeyMgr Class)

Fires for each signature of the current key when ListSignatures is called.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireSignatureList(KeyMgrSignatureListEventParams *e);

typedef struct {
  const char *UserId;
  const char *IssuerKeyId;
  const char *IssuerUserId;
  const char *PublicKeyAlgorithm;
  const char *Curve;
  const char *HashAlgorithm;
  const char *EffectiveDate;
  int SignatureClass;
  int ValidityStatus;
  int reserved;
} KeyMgrSignatureListEventParams;


Unicode (Windows)
virtual INT FireSignatureList(KeyMgrSignatureListEventParams *e);

typedef struct {
  LPCWSTR UserId;
  LPCWSTR IssuerKeyId;
  LPCWSTR IssuerUserId;
  LPCWSTR PublicKeyAlgorithm;
  LPCWSTR Curve;
  LPCWSTR HashAlgorithm;
  LPCWSTR EffectiveDate;
  INT SignatureClass;
  INT ValidityStatus;
  INT reserved;
} KeyMgrSignatureListEventParams;

#define EID_KEYMGR_SIGNATURELIST 4

virtual INT IPWORKSOPENPGP_CALL FireSignatureList(LPSTR &lpszUserId, LPSTR &lpszIssuerKeyId, LPSTR &lpszIssuerUserId, LPSTR &lpszPublicKeyAlgorithm, LPSTR &lpszCurve, LPSTR &lpszHashAlgorithm, LPSTR &lpszEffectiveDate, INT &iSignatureClass, INT &iValidityStatus);

class KeyMgrSignatureListEventParams {
public:
  const QString &UserId();

  const QString &IssuerKeyId();

  const QString &IssuerUserId();

  const QString &PublicKeyAlgorithm();

  const QString &Curve();

  const QString &HashAlgorithm();

  const QString &EffectiveDate();

  int SignatureClass();

  int ValidityStatus();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void SignatureList(KeyMgrSignatureListEventParams *e);

// Or, subclass KeyMgr and override this emitter function.
virtual int FireSignatureList(KeyMgrSignatureListEventParams *e) {...}

Remarks

This event fires once for each signature of the current key when ListSignatures is called.

UserId holds the current user Id of the key.

The UserId format is:

FirstName LastName (Comment) <Email>

IssuerKeyId is the hex-encoded, 4- or-8-byte Id of the issuer's key. It is the same as the last 4 or 8 bytes of the Fingerprint. For instance: BF52A0AB

IssuerUserId is the user Id of the issuer. If this is empty the issuer's key could not be found in the current keyring.

PublicKeyAlgorithm is the public key algorithm. Possible values are:

• RSA
• DSA
• ECDSA
• EdDSA

Curve is the curve used by the key when PublicKeyAlgorithm is ECDSA or EdDSA. Possible values are:

HashAlgorithm is the hash algorithm used by the signature. Possible values are:

• SHA1
• SHA256
• SHA384
• SHA512
• SHA224
• MD5

EffectiveDate is the date when this signature became valid. The following example illustrates the format of an encoded date: 23-Jan-2000 15:00:00 .

SignatureClass is the type of signature. Possible values are:

ValidityStatus specifies the current validity status of the signature. Possible values are:

Status Event (KeyMgr Class)

Shows the progress of the operation.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireStatus(KeyMgrStatusEventParams *e);

typedef struct {
  const char *Message;
  int reserved;
} KeyMgrStatusEventParams;


Unicode (Windows)
virtual INT FireStatus(KeyMgrStatusEventParams *e);

typedef struct {
  LPCWSTR Message;
  INT reserved;
} KeyMgrStatusEventParams;

#define EID_KEYMGR_STATUS 5

virtual INT IPWORKSOPENPGP_CALL FireStatus(LPSTR &lpszMessage);

class KeyMgrStatusEventParams {
public:
  const QString &Message();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Status(KeyMgrStatusEventParams *e);

// Or, subclass KeyMgr and override this emitter function.
virtual int FireStatus(KeyMgrStatusEventParams *e) {...}

Remarks

The event is fired for informational and logging purposes only. It may be used to track the progress of an operation.

The level of detail is controlled by the LogLevel setting.

SubkeyList Event (KeyMgr Class)

Fires once for each subkey listed when ListSubkeys is called.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireSubkeyList(KeyMgrSubkeyListEventParams *e);

typedef struct {
  const char *KeyId;
  const char *Fingerprint;
  const char *PublicKeyAlgorithm;
  int PublicKeyLength;
  const char *Curve;
  int UsageFlags;
  const char *Usage;
  const char *EffectiveDate;
  const char *ExpirationDate;
  int Revoked;
  int reserved;
} KeyMgrSubkeyListEventParams;


Unicode (Windows)
virtual INT FireSubkeyList(KeyMgrSubkeyListEventParams *e);

typedef struct {
  LPCWSTR KeyId;
  LPCWSTR Fingerprint;
  LPCWSTR PublicKeyAlgorithm;
  INT PublicKeyLength;
  LPCWSTR Curve;
  INT UsageFlags;
  LPCWSTR Usage;
  LPCWSTR EffectiveDate;
  LPCWSTR ExpirationDate;
  BOOL Revoked;
  INT reserved;
} KeyMgrSubkeyListEventParams;

#define EID_KEYMGR_SUBKEYLIST 6

virtual INT IPWORKSOPENPGP_CALL FireSubkeyList(LPSTR &lpszKeyId, LPSTR &lpszFingerprint, LPSTR &lpszPublicKeyAlgorithm, INT &iPublicKeyLength, LPSTR &lpszCurve, INT &iUsageFlags, LPSTR &lpszUsage, LPSTR &lpszEffectiveDate, LPSTR &lpszExpirationDate, BOOL &bRevoked);

class KeyMgrSubkeyListEventParams {
public:
  const QString &KeyId();

  const QString &Fingerprint();

  const QString &PublicKeyAlgorithm();

  int PublicKeyLength();

  const QString &Curve();

  int UsageFlags();

  const QString &Usage();

  const QString &EffectiveDate();

  const QString &ExpirationDate();

  bool Revoked();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void SubkeyList(KeyMgrSubkeyListEventParams *e);

// Or, subclass KeyMgr and override this emitter function.
virtual int FireSubkeyList(KeyMgrSubkeyListEventParams *e) {...}

Remarks

This event fires once for each subkey when ListSubkeys is called.

KeyId is the hex-encoded, 4- or 8-byte Id of the key. It is the same as the last 4 or 8 bytes of the Fingerprint. For instance:

BF52A0AB

Fingerprint holds the hex-encoded, 20-byte fingerprint of the key. This is in the form:

5E70662EA810E768391A2FE8F7B7D49C89C9D7B1

PublicKeyAlgorithm is the public key algorithm. Possible values are:

• RSA
• Elgamal
• ECDH (Only used with ECDSA and EdDSA keys)

PublicKeyLength is the length of the public key. Common values are 512, 1024, and 2048.

Curve is the curve used by the key when PublicKeyAlgorithm is ECDH. Possible values are:

Usage is the textual description of UsageFlags.

The value will be of one or more of the following strings, separated by commas:

• Certifying Other Certificates
• Signing Emails and Files
• Encrypting Emails and Files
• Split Key
• Authenticate Against Servers
• Group Key

UsageFlags is an integer flag that shows the intended use for the key. The value is a combination of the following flags:

EffectiveDate is the date when this key became valid. The following example illustrates the format of an encoded date: 23-Jan-2000 15:00:00.

ExpirationDate is the date the key expires. After this date the key will no longer be valid. The following example illustrates the format of an encoded date: 23-Jan-2000 15:00:00. If the ExpirationDate is not populated this indicates that the key never expires.

Revoked Indicates whether the subkey is revoked or not.

Config Settings (KeyMgr Class)

KeyMgr Config Settings

Base Config Settings

Trappable Errors (KeyMgr Class)

Error Handling (C++)

Call the GetLastErrorCode() method to obtain the last called method's result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. Known error codes are listed below. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

OpenPGP Errors