MDAC 2.5 SDK - OLE DB Providers
OLE DB Remoting Provider
To ensure compatibility with RDS version 1.5 and later, the DBPROP_MSREMOTE_CURRENT_DFMODE property determines the version of the DataFactory object instantiated. The appropriate DataFactory .dll file is shipped with each version of RDS. However, when using the object with different versions, a call to a DataFactory method when using the following interfaces can change DFMODE:
Invoking the correct or explicit version of the DataFactory can be accomplished by using the properties described in the following table.
| Property | Description |
| DBPROP_MSREMOTE_DFMODE | Read/Write. User sets this property to the current version of the remote DataFactory. If an older version is detected, the Remoting Provider sets DBPROP_MSREMOTE_CURRENT_DFMODE to that version. |
| DBPROP_MSREMOTE_CURRENT_DFMODE | Defaults to 21 or the value of DBPROP_MSREMOTE_DFMODE if it is set to a valid value, or the returned version number of the remote DataFactory. |
The property values for DBPROP_MSREMOTE_CURRENT_DFMODE are described in the following table.
| Property value | Description |
| 15 | Assumes DataFactory version 1.5. |
| 20 | Assumes DataFactory version 2.0. |
| 21 | Assumes DataFactory version 2.1 and new DataFactory methods will be used.
If the value is 21 and a method-not-found error occurs, DBPROP_MSREMOTE_CURRENT_DFMODE is automatically changed to 20. If 21 functionality is used and the mode is less than 21, an error will be returned stating that functionality is not available. |
| Any other | An error will be returned. |
For additional information about DataFactory object compatibility, see the ADO documentation for the "Microsoft OLE DB Remoting Provider" in the ADO Programmer's Reference.