ExtractCertificateByAuthorizedRole method: DigitalCertStore class

Syntax

ExtractCertificateByAuthorizedRole(digital_ID, auth_role, dest_location, &keystore_pwd)

Description

Use the ExtractCertificateByAuthorizedRole method to retrieve a digital certificate file to the specified location on the application server based on the specified digital ID and whether the current user has the specified role. 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.
auth_role	Specifies a role name 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.
58	The digital ID, role name, or the destination location is invalid due to being specified as an empty string.
59	There is no certificate file or password available to the specified role name.
60	The role name is not authorized or cannot be found.
61	There was an error downloading the certificate file from the database.
79	The current user does not have the specified role.