CdbError Constructor

           

Syntax Summary

CONSTRUCTORCdbError(VOID);

CONSTRUCTORCdbError(const CdbError &);

CONSTRUCTORCdbError(DAOError *perr,

BOOL bAddRef=FALSE);

(The qualifier 'CONSTRUCTOR' is merely a decoration provided to help readability. It has no syntactic value.)

Syntax / Parameters / Remarks

CONSTRUCTORCdbError(VOID);

This constructor creates an instance of the class. There are no parameters.

Syntax / Parameters / Remarks

CONSTRUCTORCdbError(const CdbError &);

Type Description
const CdbError & Reference to an object.

This constructor creates a copy of the object referenced in the parameter.

Syntax / Parameters / Remarks

CONSTRUCTORCdbError(DAOError *perr,

BOOL bAddRef=FALSE);

Type Example Description
DAOError * perr A DAO Automation interface pointer corresponding to this DAO class.
BOOL bAddRef

=FALSE

Optional. A Boolean. If TRUE, the DAO Automation interface AddRef function is called.

DAO functionality is presented through pointers to DAO Automation interfaces. This constructor makes a DAO interface available in the form of a DAO class object that provides additional functionality.

This constructor is not required for typical use. It is provided to allow easy creation of a DAO class object for those with access to the corresponding DAO interface.

When the destructor for the DAO object is invoked, the underlying Automation interface's Release member is called. If Release decrements the interface's reference count to zero, the pointer to the Automation interface can be deleted. If you don't want this to happen (for example, because you want to discard the DAO object but continue using the Automation interface), specify TRUE for the second parameter. The underlying Automation interface's AddRef member is called, which counterbalances the eventual call to Release.