Previous Topic: Sm_AgentApi_Authorize()Next Topic: Sm_AgentApi_ChangePassword()

Programming Guides › Programming Guide for C › Guidance for the Agent API in C › Agent API Function Declarations (C) › Sm_AgentApi_AuthorizeDLP()

Sm_AgentApi_AuthorizeDLP()

Determines if a defined user is authorized by SiteMinder DLP integration to access the resource and returns response attributes about the user with respect to the resource.

Syntax

int SM_EXTERN Sm_AgentApi_AuthorizeDLP (
   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,
   long*                                  pNumAttributes,
   Sm_AgentApi_Attribute_t**              ppAttributes
);

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 asking for the resource. This parameter is optional. 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 resource definition structure.

pRealm

I

A realm definition structure.

pSession

I

A session definition structure.

pNumAttributes

O

The number of returned attributes.

ppAttributes

O

A pointer to an array of response attribute definition structures.

Return Values