IErrorLog

The IErrorLog interface is an abstraction for an error log that is used to communicate detailed error information between a client and an object. The caller of the single interface method, AddError, simply logs an error where the error is an EXCEPINFO structure related to a specific property. The implementer of the interface is responsible for handling the error in whatever way it desires.

IErrorLog is used in the protocol between a client that implements IPropertyBag and an object that implements IPersistPropertyBag.

When to Implement

A container implements IErrorLog to provide a control with a means of logging errors when the control is loading its properties from the container-provided property bag.

When to Use

A control logs calls the single method in this interface to log any errors that occur when it is loading its properties.

Methods in Vtable Order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IErrorLog Method

Description

AddError

Logs an error, an EXCEPINFO structure, in the error log during the property load process for a named property.

See Also

IPersistPropertyBag, IPropertyBag