Click above to get retro games delivered to your door ever month!

 SetPrpIDAdd()
------------------------------------------------------------------------------
 Purpose:
 Add an object ID to a set property of an object.

 Syntax:
 bResult = SetPrpIDAdd( lpszObjectName1,
           wObjectType1, lpszObjectName2, wObjectType2, lpszProperty )

 Parameters:
 lpszObjectName1 The name of the bindery object to whose set property
                 theo bject lpszObjectName2 is to be added.
 wObjectType1    The type of the object lpszObjectName1.
 lpszObjectName2 The name of the bindery object to add to the set property
                 of lpszObjectName1.
 wObjectType2    The type of the object lpszObjectName2.
 lpszProperty    The name of the set property.

 Returns:
 A boolean value (TRUE or FALSE).

 Description:
 SetPrpIDAdd() adds the ID of a bindery object to a set property value
 of another object.

 lpszObjectName2 and wObjectType2 are the name and type of the object to be
 added to the set value of lpszObjectName1, where lpszObjectName1 is the
 object name and wObjectType1 is its type. lpszProperty is the name of the
 property, e.g. "SECURITY_EQUALS". The property must be of type SET.

 Returns TRUE if successful, or FALSE if an error occurs.

 Example:
 // To add the bindery object ID of user Supervisor to the SECURITY_EQUALS
 // property of user KATIE, which gives her Supervisor equivalence:
 if ( SetPrpIDAdd( "KATIE", OT_USER, "Supervisor", OT_USER,
             "SECURITY_EQUALS" ) )
    ? "User KATIE is now security equivalent to the "
    ??"Supervisor, because her SECURITY_EQUALS property "
    ??"value contains the object ID number of the Supervisor"
 endif

 Notes:
 This call may require Supervisor equivalence depending on the
 security of the object and property to which the object ID is to be added.

 For more information on objects and properties, and for a list of valid
 object and property types, see the description in Chapter 3, Bindery
 Functions.