ExtractCertificateByDigitalID method: DigitalCertStore class

Syntax

ExtractCertificateByDigitalID(digital_ID, dest_location, &keystore_pwd)

Description

Use the ExtractCertificateByDigitalID method to retrieve a digital certificate file to the specified location on the application server based on the specified digital ID. This method also returns the encrypted password for the certificate file.

Important:

Do not use this method in an implementation of the IPT_PDFSIGNATURE_INT:IPDFSignature interface class. Oracle reserves the right to modify this method in the future.

Parameters

Parameter	Description
digital_ID	Specifies the digital ID for the certificate as a string value.
dest_location	Specifies the absolute URL to store the certificate file on the application server as a string value.
&keystore_pwd	Specifies an already instantiated string variable to store the returned encrypted password.

Returns

A return code as a numeric value:

Numeric Value	Description
0	The method executed successfully.
50	The digital ID or the destination location is invalid due to being specified as an empty string.
51	There is no certificate file or password for the specified digital ID
52	The digital ID is inactive or cannot be found.
53	There was an error downloading the certificate file from the database.
56	The specified user ID is not authorized or cannot be found.
79	The current user does not have the specified role.

Example

&errCode = &oStore.ExtractCertificateByDigitalID(&digitalID, &sOutDestination, &psw);
&keystorePswd = &psw;

If &errCode > 0 Then
   &m_sError = &oStore.ErrorMessageDetail;
End-If;