Sm_AgentApi_Audit()

Programming Guides › Programming Guide for C › Agent API › Function Declarations › Sm_AgentApi_Audit()

Sm_AgentApi_Audit()

Call this function if the authorizations are to be done out of agent cache.

Syntax

int Sm_AgentApi_Audit (
   const void*                            pHandle,
   const char*                            lpszClientIpAddr,
   const char*                            lpszTransactionId,
   const Sm_AgentApi_ResourceContext_t*   pResourceContext,
   const Sm_AgentApi_Realm_t*             pRealm,
   Sm_AgentApi_Session_t*                 pSession
);

Parameter	I/O	Description
pHandle	I	Agent API session handle returned in parameter ppHandle of Sm_AgentApi_Init().
lpszClientIpAddr	I	The IP address of the client where the user is logging in. This is an optional parameter. If the client IP begins with a star (*), the Policy Server logs the IP address but does not validate it against a session specification.
lpszTransactionId	I	The ID that the agent uses to associate application activity with security activity. The Policy Server logs this ID. This is an optional parameter.
pResourceContext	I	A defined resource definition structure.
pRealm	I	A realm definition structure.
pSession	I	A session definition structure.

ReturnValues

SM_AGENTAPI_YES. The operation succeeded.
SM_AGENTAPI_NO. The operation failed.
SM_AGENTAPI_NOCONNECTION. The initialization was not done.
SM_AGENTAPI_FAILURE. The server could not be reached.
SM_AGENTAPI_TIMEOUT. The function timed out.

Email CA about this topic