Programming Guides › Programming Guide for C › Policy Management API › Policy Management API Overview › Object Identifiers

Object Identifiers

With the introduction of nested realms, the unique identification of an object can no longer rely on a realm name. When a SiteMinder object is created, a unique object identifier (OID) is written in the pszOid field of the object's defining structure.

These functions do not return SiteMinder objects. Instead, they return an array of string pointers that contain the OIDs of SiteMinder objects. You pass in OIDs to SiteMinder Object Retrieval Functions (Sm_PolicyApi_Get...) to specify objects to retrieve.

The functions that return arrays of OIDs are:

• Sm_PolicyApi_GetDomainObjects()
• Sm_PolicyApi_GetGlobalObjects()
• Sm_PolicyApi_GetUserDirSearchOrder()

Free the memory allocated by this group of functions by calling Sm_PolicyApi_FreeMemoryEx().