Sun OpenSSO Enterprise 8.0 C API Reference for Application and Web Policy Agent Developers

am_web_handle_notification()

Handles notification data received by a web agent.

Details

am_web_handle_notification() generates logging messages for the event and any error that may occur during the processing of the notification.

Syntax

#include "am_web.h"
AM_WEB_EXPORT void
am_web_handle_notification(const char *data,
                           size_t data_length,
                           void* agent_config);

Parameters

This function takes the following parameters:

data

Pointer to the notification message as an XML string.

data_length

Value based on the size_t defined in the standard <stddef.h> header file that reflects the length of the notification message.

agent_config

An agent configuration instance returned by am_web_get_agent_configuration(). This parameter should not be NULL.

Returns

This function returns no value.