Generic Function

Summary

Reports on failures to find or create a component.

Package

capi

Signature

report-active-component-failure pane component-name error-string function-name hresult

Arguments

pane

An ole-control-pane .

component-name

A string or nil .

error-string

A string.

hresult

An integer or nil .

Description

The generic function report-active-component-failure is used to report on failures to find or create a component.

component-name is the name of the component it tried to find.

error-string is the error string.

function-name is the name of the function that actually failed.

hresult is the hresult that came back. It may be nil if the error is that the guid of the named component could not be found.

When the system fails to open the component, it calls report-active-component-failure , with the first argument the ole-control-pane pane . The default method for ole-control-pane tries to call report-active-component-failure again on its top level interface. The default method on interface calls error .

You can add your own methods, specializing on subclasses of ole-control-pane or subclasses of interface.

Note: this function is implemented only in LispWorks for Windows. Load the functionality by (require "embed") .

Example

See the example in examples/com/ole/simple-container/doc-viewer-pair.lisp

See also

ole-control-pane