TElCertificateLookup.Options property

TElCertificateLookup.Options

TElCertificateLookup See also

Filter: C# VB.NET Pascal C++ PHP Java

Defines search options.

Declaration

[C#]
TSBLookupOptions Options;

[VB.NET]
Property Options As TSBLookupOptions

[Pascal]
property Options : TSBLookupOptions;
TSBLookupOptions = set of TSBLookupOption;

[C++]
TSBLookupOptions get_Options();
void set_Options(TSBLookupOptions Value);

[PHP]
integer get_Options()
void set_Options(integer $Value)

[Java]
short getOptions();
void setOptions(short Value);

Values:

[.NET]	[Pascal]	[C++]	Description
loExactMatch = 1	loExactMatch	f_loExactMatch = 1	loExactMatch enables strict comparison of the RDN templates (SubjectRDN and IssuerRDN). If loExactMatch option is switched off, the TElCertificateLookup's RDN properties both specify a subset of the corresponding certificate fields. If it is switched on, the lookup's RDN properties are expected to specify the exact contents of the corresponding certificate fields. For example, the filter of SubjectRDN=[C=US, O=SecureBlackbox] will return all certificates whose subject RDN contains the above entries (including [C=US, O=SecureBlackbox], [C=US, O=SecureBlackbox, CN=www.secureblackbox.com] and [C=US, O=SecureBlackbox, OU=HQ, CN=Application Signing]) if loExactMatch is set to false, but will only return [C=US, O=SecureBlackbox] of loExactMatch is set to true.
loMatchAll = 2	loMatchAll	f_loMatchAll = 2	Certificate must match all criteria if this option is included.If not set, certificate must match at least one criterion
loCompareRDNAsStrings = 4	loCompareRDNAsStrings	f_loCompareRDNAsStrings = 4	Matches issuer's RDN

TSBLookupOptions values

[.NET][C++]	[Pascal]	[PHP]	Description
f_loExactMatch = 1	loExactMatch	loExactMatch = 1	loExactMatch enables strict comparison of the RDN templates (SubjectRDN and IssuerRDN). If loExactMatch option is switched off, the TElCertificateLookup's RDN properties both specify a subset of the corresponding certificate fields. If it is switched on, the lookup's RDN properties are expected to specify the exact contents of the corresponding certificate fields. For example, the filter of SubjectRDN=[C=US, O=SecureBlackbox] will return all certificates whose subject RDN contains the above entries (including [C=US, O=SecureBlackbox], [C=US, O=SecureBlackbox, CN=www.secureblackbox.com] and [C=US, O=SecureBlackbox, OU=HQ, CN=Application Signing]) if loExactMatch is set to false, but will only return [C=US, O=SecureBlackbox] of loExactMatch is set to true.
f_loMatchAll = 2	loMatchAll	loMatchAll = 2	Certificate must match all criteria if this option is included.If not set, certificate must match at least one criterion
f_loCompareRDNAsStrings = 4	loCompareRDNAsStrings	loCompareRDNAsStrings = 4	Matches issuer's RDN

Description

Use this property to specify the search options.
Note, Options assigning differs for VCL and .NET versions. To enable several options in .NET use bitwise OR operation, for example ‘loExactMatch | loMatchAll’.