get-error-info

Summary

Retrieves the error information for the current Automation method.

Signature

get-error-info &key errorp fields => field-value *

Arguments

errorp

A boolean. If non nil and an error occurs while retrieving the error information, an error of type com-error is signalled. Otherwise nil is returned.

fields

A list of keywords specifying the error information fields to return.

Values

field-value*

Values corresponding to the fields argument.

Description

The function get-error-info allows the various components of the error information to be retrieved for the last Automation method called. The fields should be a list of the following keywords, to specify which fields of the error information should be returned:

:iid

A refguid object.

:source

A string specifying the ProgID.

:description

A string describing the error.

:help-file

A string giving the help file's path.

:help-context

An integer giving the help context id.

A field-value will be returned for each field specified. The field-value will be nil if the field is does not have a value.

When running on 64-bit Windows, 32-bit LispWorks looks in the 32-bit registry view and 64-bit LispWorks looks in the 64-bit registry view. LispWorks does not change the registry reflection settings.

Example

(multiple-value-bind (source description)

    (get-error-info :fields '(:source :description))

  (error "Failed with '~A' in ~A" description source))