Sm_AgentApi_DelSessionVariables()

Deletes the specified session variables from the session store.
casso126
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().