cgireadstate() function is an internal API function that
parses the state cookie for state variables, reading the state file if
needed. It returns the status: 1 if success and 0 if error (no state
cookie, no file, etc.).
This function never needs to be called by the user; the state is automagically read when needed. It can be used to explicitly get the status of the state parse/read operation if desired.