This documentation supports the 18.05 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

AREAFreeCallback

Description

This optional function frees the data associated with the AREAResponseStruct, which the AREAVerifyLoginCallback function returns. Although the plug-in server normally frees the storage that other API calls return, it does not free the storage that this API call returns. Instead, the plug-in server calls this function so the plug-in can deallocate the storage. This allows the plug-in to cache information, if needed.

The plug-in server calls this function after it calls the AREAVerifyLoginCallback call. The AREAVerifyLoginCallback call returns a pointer to the response structure as a parameter.

To be thread-safe, your plug-in must protect any global information or resources accessed here with appropriate mutual exclusion locks.

An AREA plug-in implementation must return a response. A NULL response indicates a failed login attempt.

Important

You must free whatever storage is allocated for the purpose of this response only. For example, if you get the response data from a prebuilt cache constructed during initialization, you do not free anything here. If you do not get the data from a prebuilt cache, you should deallocate response data here.

Synopsis


#include "area.h"

int AREAFreeCallback(
   void *object,
   AREAResponseStruct *response)

Input arguments

object

Pointer to the plug-in instance that the call to ARPluginCreateInstance returned.

response

Pointer to the response structure that the call to AREAVerifyLoginCallback returns.

See also

AREAVerifyLoginCallback.

Was this page helpful? Yes No Submitting... Thank you

Comments