Parses and processes an SSO or policy notification message as an XML string. If the message is an SSO notification, any SSO Token listeners registered using am_sso_add_listener() will be called. If the notification message is a policy notification, the internal policy cache maintained by the policy module in the C SDK will be updated with the notification information if the policy module in the C SDK has been initialized (using am_policy_init() and am_policy_service_init() ).
#include "am_notify.h" AM_EXPORT am_status_t am_notify(const char *xmlmsg, am_policy_t policy_handle);
This function takes the following parameters:
XML message containing the notification message.
The policy handle created from am_policy_service_init(). NULL if policy is not initialized or not used.
This function returns am_status_t with one of the following values:
If XML message was successfully parsed and processed.
If any input parameter is invalid.
If there was an error parsing the XML message.
If there was an error dispatching the listener(s).
If any other error occurred.
This function should be called by the service listening on the notification URL given in the properties file if notification is enabled.