SubkeyList Event

Fires once for each subkey listed when ListSubkeys is called.

Syntax

 virtual int FireSubkeyList(KeyMgrSubkeyListEventParams *e);

 
 typedef struct {

  char* KeyId;
  char* Fingerprint;
  char* PublicKeyAlgorithm;
  int PublicKeyLength;
  int UsageFlags;
  char* Usage;
  char* EffectiveDate;
  char* ExpirationDate;
  int Revoked;

  int reserved;

 } KeyMgrSubkeyListEventParams;

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" and "DSA".

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

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:


0x01	This key may be used to certify other keys.
0x02	This key may be used to sign data.
0x0C	This key may be used to encrypt communications and encrypt storage.
0x10	The private component of this key may have been split by a secret-sharing mechanism.
0x20	This key may be used for authentication.
0x80	The private component of this key may be in the possession of more than one person.

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.