hc_session_get_status

Gets the session status.

Synopsis

    hcerr_t hc_session_get_status(hc_session_t *session, 
          int32_t *response_codep,char **errstrp);

Description

This function returns the HTTP response code and the error message string associated with the last request on this session.

Parameters

session

IN: The session object.

response_codep

OUT: Updated to be the HTTP response code.

errstr

IN: Updated to be the error returned in the response body if the response code is not 200 (OK). errstr should not be written to by the application (that is, it is read only), and will persist until the next request to the 5800 system server or until hc_session_free is called, whichever comes first.

Return Codes

      HCERR_OK
     HCERR_BAD_REQUEST
     HCERR_OOM
     HCERR_NULL_SESSION
     HCERR_INVALID_SESSION