GetSampleCert Method

Generates a sample certificate for the specified purpose.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int GetSampleCert(const char* lpszPurpose, const char* lpszSubject);

Unicode (Windows)
INT GetSampleCert(LPCWSTR lpszPurpose, LPCWSTR lpszSubject);

- (void)getSampleCert:(NSString*)purpose :(NSString*)subject;

#define MID_CERTIFICATEMANAGER_GETSAMPLECERT 16

SECUREBLACKBOXLITE_EXTERNAL int SECUREBLACKBOXLITE_CALL SecureBlackboxLite_CertificateManager_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method generates a sample self-signed certificate for the specified purpose. Use it as a quick method to get a working certificate to evaluate or test a piece of functionality that relies on certificates. The certificate will use pre-defined settings for most of its fields; use Generate method to generate bespoke real-world certificates. Purpose specifies the intended use of certificate:

• "generic": a generic certificate with no specific purpose
• "tls": a TLS server certificate
• "tls-client": a client-side TLS certificate
• "email": a secure e-mail (S/MIME) certificate

Subject specifies the common name to include in the certificate (e.g. "*.domain.com")

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