Sm_PolicyApi_RemoveResponseAttr()

Programming Guides › Programming Guide for C › Policy Management API Guidance › Function Declarations for the Policy Management API › Sm_PolicyApi_RemoveResponseAttr()

Sm_PolicyApi_RemoveResponseAttr()

Disassociates the response attribute defined by the pstructResponseAttr structure from the response identified by pszResponseAttrOid. The attribute name and attribute value must match in order for the remove to occur.

Type

Response function, domain scope.

Syntax

int SM_EXTERN Sm_PolicyApi_RemoveResponseAttr (
   void*          pSessionHandle,
   const char*    pszResponseAttrOid
);

Parameter	I/O	Description
pSessionHandle	I	A pointer to an internal Policy Management API data structure. The structure holds information about the administrator session and the client session.
pszResponseAttrOid	I	A null-terminated string containing the object identifier of an existing response attribute.

Returns

Sm_PolicyApi_Success. The remove operation was successful.
Sm_PolicyApi_Failure. The remove operation was not successful.
Sm_PolicyApi_NoSession. There is no valid administrator session.
Sm_PolicyApi_InvalidHandle. There was no valid initialization prior to this call.
Sm_PolicyApi_NoPrivilege. The administrator does not have the privilege to remove a response attribute.
Sm_PolicyApi_InvalidOid. The response attribute OID was not found.