Sm_PolicyApi_GetGlobalObjects()
Retrieves the object identifiers of global objects of a specified type. Beginning at stmndr v6.0, this function will accept rule, policy, and response properties as global objects, and will return global rules, policies, and responses.
sm1252sp1
Retrieves the object identifiers of global objects of a specified type. Beginning at
CA Single Sign-On
v6.0, this function will accept rule, policy, and response properties as global objects, and will return global rules, policies, and responses.The returned values are contained in structure Sm_PolicyApi_Oid_t. Free the memory allocated for this structure by calling Sm_PolicyApi_FreeMemoryEx().
In releases prior to
CA Single Sign-On
v4.5, the functionality provided by Sm_PolicyApi_GetGlobalObjects() was provided by Sm_PolicyApi_GetGlobalObjectNames().Type
General object function, global scope.
Syntax
int SM_EXTERN Sm_PolicyApi_GetGlobalObjects (void*pSessionHandle,const Sm_PolicyApi_Objects_tnObjectId,Sm_PolicyApi_Oid_t**ppstructObject);
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. |
nObjectId
| I | The type of global object to retrieve. Object types are enumerated in Sm_PolicyApi_Objects_t. |
ppstructObject
| O | The address of a pointer to a Sm_PolicyApi_Oid_t structure. |
Returns
- Sm_PolicyApi_Success. The get operation was successful.
- Sm_PolicyApi_Failure. Memory could not be allocated to Sm_PolicyApi_Oid_t.
- 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 get global objects.
- Sm_PolicyApi_Invalid. A non-global object identifier was specified.