Sm_AgentApi_DelSessionVariables()

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

Sm_AgentApi_DelSessionVariables()

Deletes the specified session variables from the session store.

Syntax

int Sm_AgentApi_DelSessionVariables (
   const void*                           pHandle,
   const Sm_AgentApi_ResourceContext_t*  pResourceContext,
   const char*                           lpszSessionId,
   long                                  nNumReqAttributes,
   Sm_AgentApi_Attribute_t*              pReqAttributes,
   long*                                 pRespNumAttributes,
   Sm_AgentApi_Attribute_t**             ppRespAttributes
);

Parameter	I/O	Description
pHandle	I	Agent API session handle returned in parameter ppHandle of Sm_AgentApi_Init().
pResourceContext	I	Reserved for future use. Set all fields to 0.
lpszSessionId	I	A unique identifier of the session for which the variable is to be deleted. Variables can only be deleted for an active session. After a successful login, the session ID is returned in the lpszSessionId field of the structure Sm_AgentApi_Session_t.
nNumReqAttributes	I	Size of the array of session variables in pReqAttributes.
pReqAttributes	I	An array of attributes representing the names of session variables to be deleted. Set the variable name in the field lpszAttributeOid of structure Sm_AgentApi_Attribute_t. Set the nAttributeFlags field of the Sm_AgentApi_Attribute_t structure to SM_AGENTAPI_REQATTR_FLAGS_NONE. The structure’s nAttributeId and nAttributeTTL fields are ignored.
pRespNumAttributes	O	Size of the array of responses, if any, in ppRespAttributes.
ppRespAttributes	O	If all the specified variables are deleted, no response attributes are returned in this parameter. If this function returns SM_AGENTAPI_UNRESOLVED, the response attribute result set will contain variables that could not be deleted. Also, each response attribute will have the field nAttributeFlags of the structure Sm_AgentApi_Attribute_t set to SM_AGENTAPI_RESPATTR_FLAGS_UNRESOLVED. The structure’s nAttributeId and nAttributeTTL fields are ignored.

Return Values

SM_AGENTAPI_YES. The operation succeeded.
SM_AGENTAPI_NO. The call was refused.
SM_AGENTAPI_UNRESOLVED. Some variables could not be deleted. See the description of the ppRespAttributes parameter.
SM_AGENTAPI_NOCONNECTION. The initialization was not done.
SM_AGENTAPI_FAILURE. The server could not be reached.
SM_AGENTAPI_TIMEOUT. The function timed out.

Remarks

This function fails if the session referenced by lpszSessionId is not active, or the connection to the session store is lost.

To release the memory allocated for any variables returned in the ppRespAttributes parameter, call Sm_AgentApi_FreeAttributes().

More Information:

Sm_AgentApi_FreeAttributes()