www.LinuxHowtos.org

NE_REDIRECT_REGISTER

Section: neon API reference (3)
Updated: 23 November 2024
Index Return to Main Contents

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.

COPYRIGHT