Function kcHttpGetQuery

The function kcHttpGetQuery returns the query of the HTTP request normalized with KC_HTTP_NORM_UNRESERVED.

This function may be called both in program unit and HTTP exit program.
In the program unit the function may only called in the first program unit run of a service.

Function declaration kcHttpGetQuery

kc_http_retcode kcHttpGetQuery( char *  httpQuery,
                                int *   httpQueryLth
                              );

This function has following function parameter:

<<	httpQuery	The pointer to a buffer in which the query of the HTTP request is returned. The length of the buffer must be at least httpQueryLth bytes.
<>	httpQueryLth	The pointer to a variable in which the length of the buffer for the query of the HTTP request is passed and the actual length of the query is returned.

Description of returned value of function call:

KC_HTTP_OK

The function has successfully terminated.

KC_HTTP_FUNCTION_CALL_NOT_ALLOWED

The function was called by the KDCS program unit before the KDCS call INIT was executed or not in the first program unit run or outside an HTTP exit program.

KC_HTTP_NO_HTTP_CLIENT

The calling service was not initiated by an HTTP client.

KC_HTTP_PARAM_VALUE_NULL

The pointer to the buffer for the query httpQuery or the pointer to the length of the query httpQueryLth is NULL.

KC_HTTP_INVALID_LENGTH

The value of the length of query httpQueryLth is lower or equal 0.

KC_HTTP_RESULT_TRUNCATED

The length of the buffer for the query is less than the actual length of the query. The query is truncated and the actual length is returned.