Lets you remove a client-side digital certificate from the list of certificates. Client-side digital certificates verify the identity of the user for highly secure Web applications.

Syntax:

ClientCertificateDiscard (PKCS12 certificate)

Parameters:

PKCS12-Certificate – Public Key Cryptography Standard #12 is an industry format used for the transport, backup, and restoration of a certificate and its associated public and private key. This parameter must be an alphanumeric value.

Returns:

True when the certificate is discarded or False when the certificate is not discarded. The certificate is discarded only when the URL matches the certificate name previously added to the context by using the ClientCertificateAdd function or the Client Certificate environment settings.

Example:

ClientCertificateDiscard (my.pfx) where my.pfx is the discarded client-based digital certificate.

Note:

The certificate specified in the environment settings will be reissued when switching from runtime to the Studio, even when the certificate was discarded during runtime by using this function.

This function is supported only by HTTPFramework=S and HTTPFramework=J.

Exceptions:

This function is not supported for Rich Client and Web Client tasks.

See also:

SSL CA Certificate Files, SSL Client Certificate Files, and SSL Client Certificate Password environment settings