HP WebQoS Software manual Wqsetsessioncls

Using the WebQoS API

wq_set_session_cls()

wq_set_session_cls()

Sets the request classification rule class of the current request being processed by the NSAPI plug-in application.

To successfully use this function, The WebQoS Administrator must configure WebQoS to allow the application to modify the request classification rule class (refer to the Installing and Configuring HP WebQoS manual for more information), WebQoS must be enabled, and either

•SSL is not used and cookies are enabled, OR

•client connections must be persistent.

If SSL is used and/or cookies are disabled and client connections are not persistent, the request classification rule class set using this function is effective for the current request only (it will not be effective for subsequent requests).

This function is thread safe.

Synopsis

#include <webqosapi.h>

int wq_set_service_cls(int socketid, uint32_t cls, int *errorcode)

Link using -lqosapi_rq

Arguments

socketid	The socket file descriptor corresponding to the remote
	client connecting to the web server.
cls	The request classification rule class to which the
	application sets the request. This request classification
	rule class is set for the next and subsequent client
	requests. Refer to “cls Values” for a list of request
	classification rule class values.
errorcode	The error code returned when the return value is -1.
	Refer to “Errors” in this section for a list of error codes.

Chapter 2 17