ProSoft Technology MVI56E-LDM User Manual
Page 166
CIP API Functions
ControlLogix Platform ♦ "C" Programmable
Developer's Manual
Linux Application Development Module
Page 160 of 264
ProSoft Technology, Inc.
March 12, 2014
CurrentValue is the 64-bit Wall Clock Time counter value (UTC time), which is
the number of microseconds since 1/1/1970, 00:00 hours. This is the 'raw' Wall
Clock Time as presented by the device.
TimeZone is a NULL-terminated string that describes the timezone configured on
the controller. It includes the adjustment in hours and minutes which is used to
derive the local time value from UTC time. The TimeZone string will be
expressed in one of the following formats:
GMT+hh:mm
or
GMT-hh:mm
DSTOffset is the number of minutes (positive or negative) to be adjusted for
Daylight Savings Time.
DSTEnable indicates whether or not Daylight Savings Time is in effect ( 1 if DST
is in effect, 0 if not).
LocalTimeAdj is obsolete and is no longer used. It is retained in the structure for
backwards compatibility only and should not be used.
SystemTime is a structure of type SYSTEMTIME. The time and date returned in
this structure is UTC time. The SYSTEMTIME structure is as shown:
typedef struct_SYSTEMTIME
{
WORD wYear;
WORD wMonth;
WORD wDayOfWeek;
WORD wDay;
WORD wHour;
WORD wMinute;
WORD wSecond;
WORD wMilliseconds;
} SYSTEMTIME, *PSYSTEMTIME;
Return Value
OCX_SUCCESS
WCT object was retrieved successfully
OCX_ERR_NOACCESS
apihandle does not have access
OCX_ERR_MEMALLOC
returned if not enough memory is available
OCX_ERR_BADPARAM
returned if parameter was invalid
OCX_ERR_NODEVICE
the device does not exist
OCX)CIP_INVALID_REQUEST the device does not support the object
Example
OCXHANDLE apihandle;
OCXCIPWCTUTC Wct;
BYTE Path[]="p:1,s:0"; //5550 in Slot 0
int rc;