Deprecated: From version 12.55. Use web_set_certificate_ex.

Causes a script to use a specific certificate that is listed in the Internet Explorer registry.

C Language

int web_set_certificate( const char *CertificateNumber ); 

Java Language

int object.set_certificate( String certificateNumber);
The number of the certificate within the list of certificates in Internet Explorer. The number is passes as a string, for example: ("3").

Return Values

This function returns LR_PASS (0) on success, and LR_FAIL (1) on failure.


The following argument(s) can be parameterized using standard parameterization: CertificateNumber

General Information

web_set_certificate specifies the number of a certificate within the list of certificates. The specified certificate is then used whenever a secure web server requires the client to present a certificate.

When installing a certificate with private key in Internet Explorer, if you choose strong private key protection, you can set the security level of this certificate. The default is medium. The socket mode cannot handle high level security with the CertificateNumber parameter. If you do not use CertificateNumber, the security level can be high but then you must provide the certificate password.

The Wininet mode only handles the low security level.