AddRecipientCert Method

Used to add recipient certificates used to encrypt messages.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int AddRecipientCert(const char* lpCertEncoded, int lenCertEncoded);

Unicode (Windows)
INT AddRecipientCert(LPCSTR lpCertEncoded, INT lenCertEncoded);

- (void)addRecipientCert:(NSData*)certEncoded;

#define MID_CMS_ADDRECIPIENTCERT 3

IPWORKSENCRYPT_EXTERNAL int IPWORKSENCRYPT_CALL IPWorksEncrypt_CMS_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method adds a public certificate used when Encrypt is called. Public certificates of recipients may be added using this method or by adding a certificate directly to the RecipientCerts property.

CertEncoded must contain the PEM or Base64 encoded public certificate.

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