extfn_use_new_api method

To notify the database server that the external library is written using the external function call API, your external library must export the following function:

Syntax

a_sql_uint32 extfn_use_new_api( );

Returns

The function returns an unsigned 32-bit integer. The returned value must be the API version number, EXTFN_API_VERSION, defined in extfnapi.h. A return value of 0 means that the old API is being used.

Remarks

If the function is not exported by the library, the database server assumes that the old API is in use. The new API must be used for all Unix platforms and for all 64-bit platforms, including 64-bit Windows.

A typical implementation of this function follows:

a_sql_uint32 extfn_use_new_api( void )
{
    return( EXTFN_API_VERSION );
}