GetLatestEventObservation
From The Contingency Market
Contents |
GetLatestEventObservation(ulSessionID,uSequenceID,sIntegrity,sEventID,bOfficialOnly)
Returns the latest observation of this event if any (optionally only the official one). An observation of an event is either an observation that it occurred, or an observation that it became impossible.
PARAMETERS
-
ulong ulSessionID - ID of authenticated session.
-
uint uSequenceID - Sequence number.
-
string sIntegrity -
md5("ipaddr(sid,seq)->GetLatestEventObservation(sEventID,bOfficialOnly)/secret") -
string sEventID - ID of event whose observation should be returned.
-
bool bOfficialOnly - true if only the latest official observation is required.
RETURNS
[ SEventRecordData {sEventID,sParameterValue,sParameterType,sAgentIDObserver,bOccurred,sTimeOccurred,sTimeObserved} ]
-
string sEventID - ID of event observed to occur.
-
string sParameterValue - The value the event parameter is observed to have (blank if unknown).
-
string sParameterType - Type of the parameter.
-
string sAgentIDObserver - Empty if official, otherwise ID of most recent observer.
-
bool bOccurred - True if this is a record of the event occurring, False if a record of the event becoming impossible.
-
string sTimeOccurred - Time at which the event occurred/or not.
-
string sTimeObserved - Time this event record was originally submitted - Blank for official observations.
FAULTS
Session.
TEST
GetLatestEventObservation() according to the respective template currently returns Event #185d426e5d434d79a044434a376c971a was registered observed by agent # at 1787-09-17T12:00:00.0000000Z to have a perpetual value of 1:Count(Number) as at 1787-09-17T12:00:00.0000000Z, which means that it is occurring.

