Database Interface

Typedefs
typedef int(*	DatabaseFunc_HandleRequest )(DBMessage *msg)
	UserFunction called to handle a database request. More...

Functions
int	mdlDB_attachActiveEntityDscr (MSElementDescrH elDscr)
	Links a complex element contained in an element descriptor with the active entity. More...
int	mdlDB_attachActiveEntityElement (MSElementP out, MSElementP in)
	Links a graphic element with the active entity. More...
int	mdlDB_buildDALinkFromLink (UShort attributes[], int *linkLength, DatabaseLink *link)
	Used to build a displayable attribute linkage from an existing database linkage. More...
int	mdlDB_closeReport ()
	Closes report tables in the database after report generation. More...
int	mdlDB_copyElement (MSElementP el)
	Processes the attribute linkages of an element as if the element were copied in the design file using a MicroStation command. More...
int	mdlDB_decodeLink (DatabaseLink *link, UShort attributes[])
	Extracts linkage parameters from a database linkage. More...
int	mdlDB_defineAEByLink (DatabaseLink *link)
	Used to define a new active entity based on a database linkage. More...
int	mdlDB_defineAEBySQLInsert (WCharCP sqlInsert)
	Used to define a new active entity from an SQL INSERT statement. More...
int	mdlDB_defineAEBySQLSelect (WCharCP sqlSelect)
	used to define an active entity based on an existing row in a database table. More...
int	mdlDB_defineFenceFilter (WCharCP filter)
	Used to establish a new fence filter for a database table. More...
int	mdlDB_deleteElement (MSElementP el)
	Processes an element's attribute linkages as if the element were deleted from the design file with a MicroStation command. More...
int	mdlDB_detachAttributesDscr (MSElementDescrH elDscrPP)
	Removes only attribute linkages recognized by the database server from the complex element contained in the element descriptor pointed to by elemDscrPP. More...
int	mdlDB_detachAttributesElement (MSElementP out, MSElementP in)
	Removes only attribute linkages recognized by the database server from the input element in. More...
int	mdlDB_displayActiveEntity ()
	Displays the active entity. More...
int	mdlDB_editActiveEntity ()
	Displays the active entity and allows editing of the individual fields. More...
int	mdlDB_elementFilter (MSElementCP el)
	Tests to determine whether an element contains attribute data linkages that belong to the database server. More...
int	mdlDB_elementReport (MSElementP el)
	Processes database linkages on the input element in. More...
int	mdlDB_encodeLink (UShort attributes[], DatabaseLink *link)
	Used to convert a database linkage from internal format link to one in external file format attributes. More...
int	mdlDB_executeScreenForm (WCharCP formName, WCharCP arguments)
	Calls a database screen form. More...
int	mdlDB_fenceFilter (MSElementP el)
	Tests to determine whether an element contains attribute data linkages that belong to the database server and satisfy the current DEFINE SEARCH criteria. More...
int	mdlDB_largestMslink (UInt32 *mslinkKey, WCharCP tableName)
	Returns the highest MSLINK key of table tableName in mslink. More...
int	mdlDB_loadDADscr (MSElementDescrH elDscr)
	Loads a displayable attribute text node with attribute information from the database. More...
int	mdlDB_openReport ()
	Initializes the report tables in the database to prepare for report generation. More...
int	mdlDB_reviewAttributes (MSElementP el)
	Interactively reviews attribute linkages present on an element. More...
static void	SetHandleRequestFunction (DatabaseFunc_HandleRequest requestFunction)
	An MDL application can use this to set a function to be called when a database request needs to be handled. More...
int	mdlDB_findLinks (LinkInfo **linksPP, int *numLinksP, DgnModelRefP modelRef, int entity, UInt32 mslink)
	Searches MicroStation's cache of element locations by mslink and entity, and returns an allocated array of information on found elements. More...
bool	mdlDB_isActive ()
	Informs the caller if there is an active database connection. More...
bool	mdlDB_isAutoCommit ()
	Informs the caller of the current Auto Commit Mode. More...
int	mdlDB_changeDatabase (int iDatabaseServerId, WCharCP sLoginString)
	Attempts to change the database connection to the specified database server with the given login string. More...
int	mdlDB_buildDBLinkExternal (void *p, int *length, int linkFormat, int properties, int linkageClass, int entity, UInt32 mslink, int dasType, bool databaseActive, DBType **dbTypeArray, int dbTypeArrayLength)
	Creates and returns a data linkage to an external database. More...
void	mdlDB_logSessionDebug (WCharCP logMessage)
	Used to send session debug messages to the MicroStation log file. More...

Detailed Description

Typedef Documentation

typedef int(* DatabaseFunc_HandleRequest)(DBMessage *msg)

UserFunction called to handle a database request.

Parameters

[in]

msrg

The database request packet.

Returns

Return SUCCESS to indicate that the request was handled.

Remarks

Required Library: mdlbltin.lib

Function Documentation

int mdlDB_attachActiveEntityDscr

(

MSElementDescrH

elDscr

)

Links a complex element contained in an element descriptor with the active entity.

The active entity must have been established with the MicroStation FIND, CREATE ENTITY, DEFINE AE or ACTIVE ENTITY command. The database linkage that is created will be appended to any existing attributes present on the complex element pointed to by elemDscrPP. No existing linkages will be disturbed.

Parameters

[in,out]

elDscr

Element descriptor to link to AE.

Remarks

If the linkage generation mode is NEW, the database server copies the active entity and adds a new record to the database.

The MicroStation configuration variable MS_LINKTYPE controls the linkage format.

Returns

SUCCESS is returned if the active entity is successfully linked to the input graphic elements. Error codes are listed in dberrs.h.

See also

mdlDB_attachActiveEntityElement mdlDB_buildLink mdlElement_appendAttributes

Remarks

Required Library: mdlbltin.lib

int mdlDB_attachActiveEntityElement	(	MSElementP	out,
		MSElementP	in
	)

Links a graphic element with the active entity.

The active entity must have been established with the MicroStation FIND, CREATE ENTITY, DEFINE AE or ACTIVE ENTITY commands. The database linkage that is created will be appended to existing attributes present on the input element in, creating the output element out. No existing linkages will be disturbed.

Parameters

[out]	out	Element with active entity attachment.
[in]	in	Element to attach active entity.

Remarks

If the linkage mode is NEW, the database server will copy the active entity and add a new record to the database.

The MicroStation configuration variable MS_LINKTYPE controls the linkage format.

Returns

SUCCESS is returned if the active entity is successfully linked to the input graphic elements. Error codes are listed in dberrs.h.

See also

mdlDB_attachActiveEntityDscr mdlDB_buildLink mdlElement_appendAttributes

Remarks

Required Library: mdlbltin.lib

int mdlDB_buildDALinkFromLink	(	UShort	attributes[],
		int *	linkLength,
		DatabaseLink *	link
	)

Used to build a displayable attribute linkage from an existing database linkage.

Remarks

The displayable attribute linkage created is based on the linkage link. The displayable attribute linkage will reference the same entity number and MSLINK key contained in linkage link. The active displayable attribute type will be used to determine the formatting of the displayable attributes.

Parameters

[out]	attributes	The argument attributes receives the completed displayable attribute linkage. The displayable attribute linkage is in external file format and may be directly appended to an element with a function such as mdlElement_appendAttributes. The argument linkLength receives the length, in words, of the displayable attribute linkage.
[out]	linkLength	Length (words) of linkage.
[in]	link	database linkage

Returns

SUCCESS is returned if the displayable attribute linkage was created successfully. Other error codes are listed in dberrs.h.

See also

mdlDB_activeDAType mdlDB_loadDADscr

Remarks

Required Library: mdlbltin.lib

int mdlDB_buildDBLinkExternal	(	void *	p,
		int *	length,
		int	linkFormat,
		int	properties,
		int	linkageClass,
		int	entity,
		UInt32	mslink,
		int	dasType,
		bool	databaseActive,
		DBType **	dbTypeArray,
		int	dbTypeArrayLength
	)

Creates and returns a data linkage to an external database.

Parameters

[out]	p	Data buffer to fill with linkage.
[out]	length	Size in words of finished linkage.
[in]	linkFormat	ORACLE, IX etc.
[in]	properties	Linkage properties.
[in]	linkageClass	Linkage class.
[in]	entity	Entity number.
[in]	mslink	Mslink key field value.
[in]	dasType	Displayable attribute type.
[in]	databaseActive	If true, then dbTypeArray and dbTypeArrayLength are used.
[in]	dbTypeArray	A pointer to an array of database types.
[in]	dbTypeArrayLength	The number of database types in dbTypeArray.

Returns

SUCCESS

Remarks

RDBMSLIB.DLO must be linked with your application to resolve this function.

Required Library: mdlbltin.lib

int mdlDB_changeDatabase	(	int	iDatabaseServerId,
		WCharCP	sLoginString
	)

Attempts to change the database connection to the specified database server with the given login string.

Parameters

[in]	iDatabaseServerId	The database server id to change to.
[in]	sLoginString	The login string to use for the given server.

Returns

SUCCESS is returned if the connection is successful, otherwise ERROR.

Remarks

RDBMSLIB.DLO must be linked with your application to resolve this function.

Required Library: mdlbltin.lib

int mdlDB_closeReport

(

)

Closes report tables in the database after report generation.

This function has no arguments. The MicroStation command ACTIVE REPORT defines the report table name.

Remarks

Subsequent reporting operations must be preceded by mdlDB_openReport.

Returns

SUCCESSS if the report tables are successfully closed and report generation is complete. Other error codes are listed in dberrs.h.

See also

mdlDB_openReport mdlDB_elementReport

Remarks

Required Library: mdlbltin.lib

int mdlDB_copyElement

(

MSElementP

el

)

Processes the attribute linkages of an element as if the element were copied in the design file using a MicroStation command.

This function should be called to maintain the database tables in synchronization with the design file. It should be called only when elements are not copied with a MicroStation command.

Remarks

This function does not copy the graphic element in the design file. It processes only the attribute linkages. Normally, the linkage generation mode (such as NEW or DUPLICATE) will control whether new rows are added to the database.

Parameters

[in]

el

Element to process linkages.

Returns

SUCCESS is returned if the linkages are successfully processed. Other error codes are listed in dberrs.h.

See also

mdlDB_deleteElement

Remarks

Required Library: mdlbltin.lib

int mdlDB_decodeLink	(	DatabaseLink *	link,
		UShort	attributes[]
	)

Extracts linkage parameters from a database linkage.

The database server decodes the element attribute data (attributes), and the linkage parameters are returned in the link structure. Regardless of the linkage type (ORACLE or ODBC), all MicroStation database linkages can be represented by the database independent structure DatabaseLink.

Parameters

[out]	link	Datebase linkage.
[in]	attributes	Element attribute data.

Remarks

The format of the structure link is as follows:

typedef struct
    {
       unsigned short  linkSize;    // # of BYTES in linkage
       unsigned short  linkType;
       unsigned short  entity;
       WChar           tablename[64];
       unsigned long   mslink;
       LinkProps       props;
       unsigned short  dasType;
    } DatabaseLink;

The structure member linkType is set to one of the following values to represent the linkage signature:

• ORACLE_LINKAGE Oracle linkage
• ODBC_LINKAGE ODBC linkage

Returns

The mdlDB_decodeLink function returns SUCCESS if the linkage is successfully decoded. Error codes are listed in dberrs.h.

See also

mdlDB_buildLink

Remarks

Required Library: mdlbltin.lib

int mdlDB_defineAEByLink

(

DatabaseLink *

link

)

Used to define a new active entity based on a database linkage.

Parameters

[in]

link

The argument link is a pointer to a database linkage in external (file format) format. The database linkage contains an entity number which specifies the table (through MSCATALOG) and an MSLINK key which specifies the row within the table.

Remarks

The mdlDB_defineAEByLink function is equivalent to the MicroStation DEFINE AE command.

Returns

SUCCESS is returned if the active entity is successfully defined from the database linkage. Other error codes are listed in dberrs.h.

See also

mdlElement_extractAttributes mdlElmdscr_extractAttributes mdlDB_defineAEBySQLInsert mdlDB_defineAEBySQLSelect

Remarks

Required Library: mdlbltin.lib

int mdlDB_defineAEBySQLInsert

(

WCharCP

sqlInsert

)

Used to define a new active entity from an SQL INSERT statement.

It is used in NEW linkage mode to establish an active entity when there is no existing row in the database table which can be used as the basis for the active entity.

Parameters

[in]

sqlInsert

SQL SERT statement.

Remarks

Do not supply an MSLINK value in the INSERT statement. MicroStation will automatically assign a value to MSLINK when a linkage is actually created.

The mdlDB_defineAEBySQLInsert function is equivalent to the MicroStation ACTIVE ENTITY (AE=) command.

Returns

SUCCESS is returned if the active entity is successfully defined from the SQL INSERT statement. Other error codes are listed in dberrs.h.

See also

mdlDB_defineAEByLink mdlDB_defineAEBySQLSelect

Remarks

Required Library: mdlbltin.lib

int mdlDB_defineAEBySQLSelect

(

WCharCP

sqlSelect

)

used to define an active entity based on an existing row in a database table.

The argument sqlSelect defines an SQL SELECT statement. If the SELECT statement returns multiple rows the first one is used as the basis for the active entity.

Remarks

The mdlDB_defineAEBySQLSelect function is equivalent to the MicroStation FIND (FI=) command.

Parameters

[in]

sqlSelect

SQL SELECT Statement.

Returns

SUCCESS is returned if the active entity is successfully defined from the SQL SELECT statement. Other error codes are listed in dberrs.h.

See also

mdlDB_defineAEByLink mdlDB_defineAEBySQLInsert

Remarks

Required Library: mdlbltin.lib

int mdlDB_defineFenceFilter

(

WCharCP

filter

)

Used to establish a new fence filter for a database table.

The argument sqlSelect is an SQL SELECT statement which specifies a subset of a table. The fence filter will limit all fence operations to only those elements which meet both the geometric criteria of the fence and the database criteria expressed by the SELECT statement.

Remarks

Each table may have its SELECT statement filter. The FENCEFILTER column of MSCATALOG is updated with the SELECT statement sqlSelect.

The mdlDB_defineFenceFilter function is equivalent to the MicroStation DEFINE SEARCH (DS=) key-in.

Parameters

[in]

filter

Filter condition.

Returns

SUCCESS is returned if the fence filter is activated. Other error codes are listed in dberrs.h.

See also

mdlDB_fenceFilter

Remarks

Required Library: mdlbltin.lib

int mdlDB_deleteElement

(

MSElementP

el

)

Processes an element's attribute linkages as if the element were deleted from the design file with a MicroStation command.

This function should be called to maintain the database tables in synchronization with the design file. It should be called only when elements are not deleted with a MicroStation command or the mdlElement_undoableDelete function.

Remarks

This function does not delete the graphic element from the design file. It processes only the attribute linkages. Normally, the state of the SET DELETE [ON|OFF] switch will control whether linked table rows are deleted from the database.

Parameters

[in]

el

Element to process.

Returns

SUCCESS is returned if the linkages are successfully processed. Error codes are listed in dberrs.h.

See also

mdlDB_copyElement mdlElement_undoableDelete

Remarks

Required Library: mdlbltin.lib

int mdlDB_detachAttributesDscr

(

MSElementDescrH

elDscrPP

)

Removes only attribute linkages recognized by the database server from the complex element contained in the element descriptor pointed to by elemDscrPP.

No other types of user data linkages will be disturbed on the element. The configuration variable MS_LINKTYPE sets the types of linkages that the server processes.

Parameters

[in,out]

elDscrPP

Element descriptor with linkages.

Returns

SUCCESS is returned if the attribute linkages were successfully removed. Error codes are listed in dberrs.h.

See also

mdlDB_detachAttributesElement mdlElement_stripAttributes mdlElement_appendAttributes

int mdlDB_detachAttributesElement	(	MSElementP	out,
		MSElementP	in
	)

Removes only attribute linkages recognized by the database server from the input element in.

The element with no database linkages is returned in out. No other types of user data linkages will be disturbed on the element. The configuration variable MS_LINKTYPE sets the types of linkages that the server processes.

Parameters

[out]	out	Element with attributes removed.
[in]	in	Element to detach attributes.

Returns

SUCCESS is returned if the attribute linkages were successfully removed. Error codes are listed in dberrs.h.

See also

mdlDB_detachAttributesDscr mdlElement_stripAttributes mdlElement_appendAttributes

Remarks

Required Library: mdlbltin.lib

int mdlDB_displayActiveEntity

(

)

Displays the active entity.

The active entity is the target row to which graphics elements will be linked.

Remarks

The mdlDB_displayActiveEntity function is equivalent to the MicroStation SHOW AE key-in.

Returns

SUCCESS is returned if the active entity is successfully displayed. Other error codes are listed in dberrs.h.

See also

mdlDB_defineAEBySQLInsert mdlDB_defineAEBySQLSelect mdlDB_defineAEByLink mdlDB_editActiveEntity

Remarks

Required Library: mdlbltin.lib

int mdlDB_editActiveEntity

(

)

Displays the active entity and allows editing of the individual fields.

Remarks

The active entity is the target row to which graphics elements will be linked. If the active linkage mode is DUPLICATE, the active entity represents an actual table row and edits are written directly to the database. If the linkage mode is NEW, the active entity is a prototype row, and edits are written in-memory only.

The mdlDB_editActiveEntity function is equivalent to the MicroStation EDIT AE key-in.

Returns

SUCCESS is returned if the active entity is defined. Other error codes are listed in dberrs.h.

See also

mdlDB_defineAEBySQLInsert mdlDB_defineAEBySQLSelect mdlDB_defineAEByLink mdlDB_displayActiveEntity

Remarks

Required Library: mdlbltin.lib

int mdlDB_elementFilter

(

MSElementCP

el

)

Tests to determine whether an element contains attribute data linkages that belong to the database server.

Elements can contain many types of attribute data linkages that belong to either application programs or the database interface.

Remarks

The mdlDB_elementFilter function is a convenient way to determine whether the element el contains at least one linkage that belongs to the database server.

Parameters

[in]

el

Element with database linkages.

Returns

true is returned if the element has one or more linkages that belong to the database server and false if no recognized linkages are present.

See also

mdlDB_fenceFilter

Remarks

Required Library: mdlbltin.lib

int mdlDB_elementReport

(

MSElementP

el

)

Processes database linkages on the input element in.

The database server will add one row to the corresponding report table for each occurrence of an attribute linkage. The MicroStation command ACTIVE REPORT defines the report table name.

Remarks

Subsequent calls to mdlDB_elementReport will accumulate additional rows in the report tables according to the attribute linkages present on the elements.

Parameters

[out]

el

Element to add to report tables

Returns

SUCCESS is returned if the attribute linkages are successfully processed. Error codes are listed in dberrs.h.

See also

mdlDB_openReport mdlDB_closeReport

Remarks

Required Library: mdlbltin.lib

int mdlDB_encodeLink	(	UShort	attributes[],
		DatabaseLink *	link
	)

Used to convert a database linkage from internal format link to one in external file format attributes.

The length, in bytes, of the attribute linkage is given by the linkSize member of link.

Parameters

[out]	attributes	Element attribute data.
[in]	link	Database linkage.

Returns

SUCCESS is returned if the linkage was converted successfully. Other error codes are listed in dberrs.h.

See also

mdlDB_decodeLink

Remarks

Required Library: mdlbltin.lib

int mdlDB_executeScreenForm	(	WCharCP	formName,
		WCharCP	arguments
	)

Calls a database screen form.

The formname argument should point to a string containing the name of the form to be executed. Unless a full pathname is given, the path indicated by the MS_DBASE configuration variable will be searched for the form.

Parameters

[in]	formName	SQL*FORM to be displayed
[in]	arguments	Points to a string containing arguments to be passed to the forms package for the database being used. The value NULL can be passed if no arguments are needed.

Returns

SUCCESS is returned if the form is located and successfully executed. Error codes are listed in dberrs.h.

Remarks

Required Library: mdlbltin.lib

int mdlDB_fenceFilter

(

MSElementP

el

)

Tests to determine whether an element contains attribute data linkages that belong to the database server and satisfy the current DEFINE SEARCH criteria.

Elements can contain many types of attribute data linkages that belong to application programs or the database interface.

Remarks

The mdlDB_fenceFilter function is a convenient way to determine whether the element p contains at least one linkage that belongs to the database server and satisfies the current fence filter.

Parameters

[in]

el

Element with database linkages.

Returns

true is returned if the element has one or more linkages that satisfy the active fence filter and false if no linkages satisfy the filter.

See also

mdlDB_elementFilter

Remarks

Required Library: mdlbltin.lib

int mdlDB_findLinks	(	LinkInfo **	linksPP,
		int *	numLinksP,
		DgnModelRefP	modelRef,
		int	entity,
		UInt32	mslink
	)

Searches MicroStation's cache of element locations by mslink and entity, and returns an allocated array of information on found elements.

Parameters

[out]	linksPP	Is the address of a pointer that will be set to point to the allocated array. It is the caller's responsibility to free the array when no longer needed. See dbdefs.h for the declaration of the LinkInfo typedef.
[out]	numLinksP	Is the address of an integer that will be set to indicate the number of records in the array.
[in]	modelRef	Is the model in which to search, or 0 to indicate all files which can be expressed as INVALID_MODELREF, or as (DgnModelRefP) 0.
[in]	entity	Is the entity number to search by. Only elements with database linkages of this entity type will be found. Set entity to -1 to return information on all entity types.
[in]	mslink	Is the linkage number to search by. By definition, there is only one record in a database that has a given mslink value, for each entity type. Only elements with database linkages with this mslink number will be found. Set mslink to 0 to return information on all links.

Remarks

This function was implemented in MicroStation 95.

A counter part to this function mdlDB_setLinkCacheInfo is no longer available or needed. The cache is available for all linkages in all open design files.

Returns

MDLERR_NOTAVAILABLE is returned if the cache of element locations is empty, meaning either that there are no database linkages in any of the currently open files. SUCCESS is returned if elements were found, and !SUCCESS if none were found.

Remarks

Required Library: mdlbltin.lib

bool mdlDB_isActive

(

)

Informs the caller if there is an active database connection.

Returns

true is returned if the connection is active otherwise false.

Remarks

Required Library: mdlbltin.lib

bool mdlDB_isAutoCommit

(

)

Informs the caller of the current Auto Commit Mode.

Returns

true is returned if Auto Commit mode is on otherwise it is false.

Remarks

Required Library: mdlbltin.lib

int mdlDB_largestMslink	(	UInt32 *	mslinkKey,
		WCharCP	tableName
	)

Returns the highest MSLINK key of table tableName in mslink.

The largest MSLINK key in a table must be known while new rows are being added to the table. A call to mdlDB_largestMslink can be followed by mdlDB_buildLink to construct a new database linkage.

Parameters

[out]	mslinkKey	Largest value of MSLINK column.
[in]	tableName	Table Name.

Returns

SUCCESS is returned if the highest MSLINK key is successfully located. Error codes are listed in dberrs.h.

See also

mdlDB_buildLink

Remarks

Required Library: mdlbltin.lib

int mdlDB_loadDADscr

(

MSElementDescrH

elDscr

)

Loads a displayable attribute text node with attribute information from the database.

The element descriptor elemDscrPP must point to a text node element with a displayable attribute database linkage.

Remarks

Existing text elements attached to the text node are replaced with the text strings reflecting the current database attribute contents. The screen form associated with the displayable attribute type of the text node's database linkage determines the text string format. The text string properties such as font, text size, line spacing and justification are taken from the text node.

Parameters

[in,out]

elDscr

Text node to load.

Returns

SUCCESS is returned if the text node is successfully loaded. Error codes are listed in dberrs.h.

Remarks

Required Library: mdlbltin.lib

void mdlDB_logSessionDebug

(

WCharCP

logMessage

)

Used to send session debug messages to the MicroStation log file.

Parameters

[in]

logMessage

Session debug message to be written to the log file.

Remarks

RDBMSLIB.DLO must be linked with your application to resolve this function.

Required Library: mdlbltin.lib

int mdlDB_openReport

(

)

Initializes the report tables in the database to prepare for report generation.

The contents of the report table defined by the MicroStation command ACTIVE REPORT are deleted.

Remarks

Subsequent calls to mdlDB_elementReport will accumulate rows in the report tables according to the attribute linkages present on the elements.

Returns

SUCCESS is returned if the report tables were successfully initialized. Error codes are listed in dberrs.h.

See also

mdlDB_closeReport mdlDB_elementReport

Remarks

Required Library: mdlbltin.lib

int mdlDB_reviewAttributes

(

MSElementP

el

)

Interactively reviews attribute linkages present on an element.

The database server will execute the REVIEW MicroStation command for the element linkages.

Remarks

If screen forms are activated, the entity's active screen form will be used. Otherwise, the SQL SELECT statement specified by the MicroStation command ACTIVE REVIEW will control attributes displayed for each linkage.

Parameters

[in]

el

Element with database linkages.

Returns

SUCCESS is returned if the attribute linkages are successfully processed.

Remarks

Required Library: mdlbltin.lib

static void SetHandleRequestFunction ( DatabaseFunc_HandleRequest  requestFunction )

static

An MDL application can use this to set a function to be called when a database request needs to be handled.

Parameters

[in]

requestFunction

The new function to call, or NULL.

Returns

SUCCESS if the request function is valid.

Remarks

Only a single mdl application can handle database requests. The last application to call this method will supercede all other applications.

See also

DatabaseFunc_HandleRequest

Remarks

Required Library: mdlbltin.lib