Acrobat Digital Signature API Reference - Adobe Partners

PubSec Methods
PubSec Acrobat Address Book Methods
2
PubSec Acrobat Address Book Methods
These methods allow you to manage certificates in the Acrobat Address Book (AAB).
AABFindCertsByName
void AABFindCertsByName (const ASUns8* inCertNameData,
ASInt32 inCertNameSize, ASCab outResults);
Description
Does a lookup in the Acrobat Address Book by certificate subject name. Returns all
certificates that match the name along with trust information associated with them.
The returned ASCab contains:
● An entry for each certificate, with a 0-based index followed by the X509 certificate as
ASN1-encoded binary data
● An entry with a key Tn containing the associated trust value of each certificate, where n
corresponds to the certificate’s index key.
If a trust key is missing, the value should be assumed to be untrusted. For example:
{ ("0", cert1), ("1", cert2), ("T1", kPSSigTrustAuthenticDocuments) }
In this case, cert1 is untrusted, cert2 is trusted for authentic documents.
Parameters
inCertNameData
inCertNameSize
outResults
The subject name of the certificates to find. Specify a BERencoded
value of ASN.1 type Name defined in X.509 (RFC 3280).
The size of the certificate subject name data.
(Filled by the method) An ASCab containing any certificates found
by the lookup and their trust information.
Return Value
true if successful, false otherwise.
Header File
PubSecHFT.h
Related Methods
AABGetCertTrust
AABGetTrustedCerts
Acrobat Digital Signature API Reference 33