Interface nsICertificateDialogsType

Functions that implement user interface dialogs to manage certificates.

Hierarchy

Methods

AddRef QueryInterface Release confirmDownloadCACert getPKCS12FilePassword setPKCS12FilePassword

Methods

AddRef

  • Increases the reference count for this interface. The associated instance will not be deleted unless the reference count is returned to zero.

    Returns

    The resulting reference count.

    Returns number

QueryInterface

  • Parameters

    • aIID: object
    • Optional aInstancePtr: object

    Returns any

  • A run time mechanism for interface discovery.

    Returns

    NS_OK if the interface is supported by the associated instance, NS_NOINTERFACE if it is not.

    aInstancePtr must not be null.

    Parameters

    • aIID: object

      [in] A requested interface IID

    • aInstancePtr: object

      [out] A pointer to an interface pointer to receive the result.

    Returns void

Release

  • Decreases the reference count for this interface. Generally, if the reference count returns to zero, the associated instance is deleted.

    Returns

    The resulting reference count.

    Returns number

confirmDownloadCACert

  • UI shown when a user is asked to download a new CA cert. Provides user with ability to choose trust settings for the cert. Asks the user to grant permission to import the certificate.

    Returns

    true if the user allows to import the certificate.

    Parameters

    • ctx: nsIInterfaceRequestor

      A user interface context.

    • cert: nsIX509Cert

      The certificate that is about to get installed.

    • trust: number

      A bit mask of trust flags. See nsIX509CertDB for possible values.

    Returns boolean

getPKCS12FilePassword

  • UI shown when a user is about to restore a personal certificate from a backup file. The user is requested to enter the password that was used in the past to protect that backup file.

    Returns

    false if the user requests to cancel.

    Parameters

    • ctx: nsIInterfaceRequestor

      A user interface context.

    • password: string

      The password provided by the user.

    Returns boolean

setPKCS12FilePassword

  • UI shown when a user's personal certificate is going to be exported to a backup file. The implementation of this dialog should make sure to prompt the user to type the password twice in order to confirm correct input. The wording in the dialog should also motivate the user to enter a strong password.

    Returns

    false if the user requests to cancel.

    Parameters

    • ctx: nsIInterfaceRequestor

      A user interface context.

    • password: string

      The password provided by the user.

    Returns boolean

Settings

Member Visibility

Theme

Generated using TypeDoc