LogMessages Property

   

Sets or returns a value that specifies if the messages returned from a Microsoft Jet-connected ODBC data source are recorded (Microsoft Jet workspaces only).

Note Before you can set or get the value of the LogMessages property, you must create the LogMessages property with the CreateProperty method and append it to the Properties collection of a CdbQueryDef object.

Syntax

There is no member function to explicitly access this property. See Usage below for an example of how this property is managed.

Remarks

Some pass-through queries can return messages in addition to data. If you set the LogMessages property to True, the Microsoft Jet database engine creates a table that contains returned messages. The table name is the user name concatenated with a hyphen (-) and a sequential number starting at 00. For example, because the default user name is Admin, the tables returned would be named Admin-00, Admin-01, and so on.

If you expect the query to return messages, create and append a user-defined LogMessages property for the CdbQueryDef object, and set its type to Boolean and its value to True.

Once you've processed the results from these tables, you may want to delete them from the database along with the temporary query used to create them.

Usage

...
CdbDBEngine      engine;
CdbProperty      prp;
CdbQueryDef      qdf;
COleVariant      vTrue((short)TRUE, VT_BOOL);
...      
// Initialize engine, queryDef, etc.
prp = qdf.CreateProperty(
            _T("LogMessages"), dbBoolean, &vTrue);
qdf.Properties.Append( prp );
...