ProSoft Technology MVI56E-LDM - Manual (Page 127)

ControlLogix Platform ♦ "C" Programmable CIP API Functions
Linux Application Development Module Developer's Manual
ProSoft Technology, Inc. Page 121 of 264
March 12, 2014
OCXcip_TestTagDbVer
Syntax
int OCXcip_TestTagDbVer(OCXHANDLE apihandle,
OCXTAGDBHANDLE tdbHandle,
Parameters
apiHandle handle returned by previous call to OCXcip_Open
tdbHandle handle created by previous call to
OCXcip_CreateTagDbHandle
Description
This function reads the program version from target device and compares it to
the device program version read when the tag database was built.
Return Value
OCX_SUCCESS ID object was retrieved successfully
OCX_ERR_NOACCESS apihandle or tdbHandle is invalid
OCX_ERR_VERMISMATCH Database version mismatch, call OCXcip_BuildTagDb to
refresh
Example
OCXHANDLE hApi;
OCXTAGDBHANDLE hTagDb;
int rc;
rc = OCXcip_TestTagDbVer(hApi, hTagDB);
if ( rc !=OCX_SUCCESS )
{
if ( rc == OCX_ERR_OBJEMPTY || rc == OCX_ERR_MISMATCH )
rc = OCXcip_BuildTagDb(hApi, hTagDb );
}
if ( rc != OCX_SUCCESS )
printf ("Tag database not valid\n");
See Also
OCXcip_BuildTagDb