ne_redirect_register
Prev | neon API reference | Next

## Name

ne_redirect_register, ne_redirect_location — HTTP request redirect handling

## Synopsis

    #include <ne_redirect.h>

``void ne_redirect_register(`ne_session *sess`)`;`
``const ne_uri *ne_redirect_location(`ne_session *sess`)`;`

## Description

The ne_redirect_register function registers redirect handling for the session. If a valid redirect (with status code 3xx) response is processed, the request will fail with the `NE_REDIRECT` error code. The destination of the redirect can then be retrieved using `ne_redirect_location`.

If a redirect was processed, the ne_redirect_location function returns the destination URI of the redirect.

## Return value

`ne_redirect_location` returns `NULL` if no request has yet been processed, if the current request was not a redirect, or if the destination of the redirect could not be parsed or resolved. Otherwise it returns a pointer to an ne_uri object, which remains valid until another request is created for the session.

## See also

ne_session_create.

Prev | Up | Next
ne_get_request_target | Home | ne_set_server_auth