_NAME_ getStruct _PROTOTYPE_ void *getStruct(uint32 secondsSince1996, char *structName); _SHORT-DESCRIPTION_ Get a data struct valid at a particular second-since-1996 _DESCRIPTION_ getStruct retrieves any data structure of type structName from the archives which was valid at time secondsSince1996. Beware that despite the singular nature of the name, a pointer to an array of structs of type structName is always returned. This array is always terminated by a zeroed struct of type structName. The reason for this is that, due to some anomoly with the clock perhaps, more than 1 data struct may be stamped as valid during a particular interval, so there is a small chance of getting more than a single "valid" data struct back. There is a much better chance of the array only containing the terminal zeroed struct. In such a case, either no data exists during the interval or it has not yet been archived. - getStruct is really just a special case of getStructs, where both secondsSince1996Start and secondsSince1996Stop are set to the same value, secondsSince1996. - Memory has been allocated inside the call to getStruct for the array of structures returned, and this memory needs to be freed by the caller. _INPUT_ * secondsSince1996 is the second-since-1996 we are looking for valid data. * structName is the full name of the structure for the data type we are requesting (e.g., "L1CrisLowPriorityRate"). _OUTPUT_ * A pointer (void *) to an array of structures of type structName. The calling routine must cast the pointer to type structName.