CertStore Property

The name of the certificate store for the client certificate.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int GetCertStore(int iCertIndex, char* &lpCertStore, int &lenCertStore);
int SetCertStore(int iCertIndex, const char* lpCertStore, int lenCertStore);

Unicode (Windows)
INT GetCertStore(INT iCertIndex, LPSTR &lpCertStore, INT &lenCertStore);
INT SetCertStore(INT iCertIndex, LPCSTR lpCertStore, INT lenCertStore);

- (NSString*)certStore:(int)certIndex;
- (void)setCertStore:(int)certIndex:(NSString*)newCertStore;

- (NSData*)certStoreB:(int)certIndex;
- (void)setCertStoreB:(int)certIndex:(NSData*)newCertStore;

#define PID_CMS_CERTSTORE 3

IPWORKSENCRYPT_EXTERNAL void* IPWORKSENCRYPT_CALL IPWorksEncrypt_CMS_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
IPWORKSENCRYPT_EXTERNAL int IPWORKSENCRYPT_CALL IPWorksEncrypt_CMS_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);
IPWORKSENCRYPT_EXTERNAL int IPWORKSENCRYPT_CALL IPWorksEncrypt_CMS_CheckIndex(void *lpObj, int propid, int arridx);

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The CertStoreType property specifies the type of the certificate store specified by CertStore. If the store is password protected, specify the password in CertStorePassword.

CertStore is used in conjunction with the CertSubject property in order to specify client certificates. If CertStore has a value, and CertSubject or CertEncoded is set, a search for a certificate is initiated. Please refer to the CertSubject property for details.

Designations of certificate stores are platform-dependent.

The following are designations of the most common User and Machine certificate stores in Windows:

When the certificate store type is PFXFile, this property must be set to the name of the file. When the type is PFXBlob, the property must be set to the binary contents of a PFX file (i.e. PKCS12 certificate store).

The CertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CertCount property.

This property is not available at design time.

Data Type

Binary String