PreviousNext

The sec_rgy_attr_delete( ) Call

The sec_rgy_attr_delete( ) call deletes the specified attribute instances from an object identified by name and registry domain. The attribute instances to be deleted are passed in as an array of values of sec_attr_t.

To delete attribute instances that are not multivalued and to delete all instances of a multivalued attribute, an attribute UUID is all that is required. For these attribute instances, supply the attribute UUID in the input array and set the attribute encoding (in sec_attr_encoding_t) to sec_attr_enc_void.

To delete a specific instance of a multivalued attribute, you must supply the UUID and value that uniquely identify the multivalued attribute instance in the input array.

Note that, if the deletion of any attribute instance in the array fails, all fail. However, to help pinpoint the cause of the failure, the call identifies the first attribute whose deletion failed in a failure index by array element number.