IPWorks Encrypt 2020 C++ Edition

Questions / Feedback?

SignerCertSubject Property

The subject of the certificate used for client authentication.

Syntax

ANSI (Cross Platform)
char* GetSignerCertSubject(int iSignerCertIndex);
int SetSignerCertSubject(int iSignerCertIndex, const char* lpszSignerCertSubject); Unicode (Windows) LPWSTR GetSignerCertSubject(INT iSignerCertIndex);
INT SetSignerCertSubject(INT iSignerCertIndex, LPCWSTR lpszSignerCertSubject);
- (NSString*)signerCertSubject:(int)signerCertIndex;
- (void)setSignerCertSubject:(int)signerCertIndex:(NSString*)newSignerCertSubject;
#define PID_CMS_SIGNERCERTSUBJECT 29

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

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properites are set. When this property is set, a search is performed in the current certificate store certificate with matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma separated list of distinguished name fields and values. For instance "CN=www.server.com, OU=test, C=US, E=support@nsoftware.com". Common fields and their meanings are displayed below.

FieldMeaning
CNCommon Name. This is commonly a host name like www.server.com.
OOrganization
OUOrganizational Unit
LLocality
SState
CCountry
EEmail Address

If a field value contains a comma it must be quoted.

The SignerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignerCertCount property.

This property is not available at design time.

Data Type

String

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks Encrypt 2020 C++ Edition - Version 20.0 [Build 8155]