Additional Information

API documentation

The home page of the Doxygen documentation is <wincc_oa_path>/api/docu/index.html.

Migration

Please check the requirements for API development for the used version. Existing API projects must be converted and compiled with the corresponding compiler to match the API requirements:

To convert an API project from VC++ 12.0, or VC++ 14.0 to VC++ 14.1:

Open the old .sln - file with Visual Studio 2017. The project files are automatically converted to sln or. .vcxproj.

Additional Resource information

By using the VersInfo.rc file additional information can be added to the compiled object, e.g. file descriptions.

CONTROL Extensions and Version Number Check

The controller compares a version string of a CONTROL extension (dll / so) with its own version string. A CONTROL extension has to return a version string. Therefore, there are two macros CTRL_EXTENSION_VERSION and CTRL_EXTENSION (class, funcList). The BaseExternHdl.hxx defines these macros. An existing CONTROL extension has to add at least one of these macros to a .cxx file in order to use the extension with the current version. The implementation of the newExternHdl() function is not more necessary. CTRL_EXTENSION (class, funcList) also includes CTRL_EXTENSION_VERSION.

You have to only write XXXExternHdl.cxx file according to the fnList as follows:

CTRL_EXTENSION (myClassNam, fnList)