GenerateLegacy Method

Generates a new key in the old format.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int GenerateLegacy(const char* lpszUsername, int iBits, const char* lpszPassword, int iExpires);

Unicode (Windows)
INT GenerateLegacy(LPCWSTR lpszUsername, INT iBits, LPCWSTR lpszPassword, INT iExpires);

- (void)generateLegacy:(NSString*)username :(int)bits :(NSString*)password :(int)expires;

#define MID_PGPKEYMANAGER_GENERATELEGACY 15

SECUREBLACKBOX_EXTERNAL int SECUREBLACKBOX_CALL SecureBlackbox_PGPKeyManager_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Use this method when you need to generate an RSA key in the old (PGP 2.6.x) format.

Username specifies the user of the key, Bits is the key length in bits. Provide Password for the key and its expiration date and time via Expires.

Only use this method where you want to work with very old PGP software. While still providing a decent level of protection (subject to key length, of course), legacy keys are rarely used these days, and have almost everywhere been replaced with new-style keys.

Most modern PGP implementations work with pairs of keys: the sign-only primary key and the encrypt-only (or encrypt-and-sign) subkey. If you need to generate a conformant PGP key to use with other PGP software, you likely need to use the GeneratePair method.

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.)