ACSRootCertStore Property

The name of the certificate store for the client certificate.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int GetACSRootCertStore(int iACSRootCertIndex, char* &lpACSRootCertStore, int &lenACSRootCertStore);
int SetACSRootCertStore(int iACSRootCertIndex, const char* lpACSRootCertStore, int lenACSRootCertStore);

Unicode (Windows)
INT GetACSRootCertStore(INT iACSRootCertIndex, LPSTR &lpACSRootCertStore, INT &lenACSRootCertStore);
INT SetACSRootCertStore(INT iACSRootCertIndex, LPCSTR lpACSRootCertStore, INT lenACSRootCertStore);

- (NSString*)ACSRootCertStore:(int)aCSRootCertIndex;
- (void)setACSRootCertStore:(int)aCSRootCertIndex:(NSString*)newACSRootCertStore;

- (NSData*)ACSRootCertStoreB:(int)aCSRootCertIndex;
- (void)setACSRootCertStoreB:(int)aCSRootCertIndex:(NSData*)newACSRootCertStore;

#define PID_CLIENT_ACSROOTCERTSTORE 5

IPWORKS3DS_EXTERNAL void* IPWORKS3DS_CALL IPWorks3DS_Client_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
IPWORKS3DS_EXTERNAL int IPWORKS3DS_CALL IPWorks3DS_Client_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);
IPWORKS3DS_EXTERNAL int IPWORKS3DS_CALL IPWorks3DS_Client_CheckIndex(void *lpObj, int propid, int arridx);

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The ACSRootCertStoreType property specifies the type of the certificate store specified by ACSRootCertStore. If the store is password protected, specify the password in ACSRootCertStorePassword.

ACSRootCertStore is used in conjunction with the ACSRootCertSubject property in order to specify client certificates. If ACSRootCertStore has a value, and ACSRootCertSubject or ACSRootCertEncoded is set, a search for a certificate is initiated. Please refer to the ACSRootCertSubject 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 ACSRootCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ACSRootCertCount property.

This property is not available at design time.

Data Type

Binary String