cma_attr_delete

Deletes an attributes object.

Syntax

cma_attr_delete( attr);

Argument Data Type Access

attr opaque cma_t_attr modify

C Binding

#include 


void
cma_attr_delete (
         cma_t_attr   *attr);

Arguments

attr: Handle of the attributes object deleted.

Description

This routine deletes an attributes object. Call this routine when an attributes object no longer needs to be referenced through the handle supplied by the cma_attr_create routine.

The effect of this routine is to give permission to reclaim storage for the attributes object. The attributes object is marked for deletion, and the attr argument is set to the value cma_c_null. Specifying cma_c_null for the attr argument is legal and has no effect. Objects that were created using this attributes object are not affected by the deletion of the attributes object.

The results of calling this routine are unpredictable if the handle specified by the attr argument refers to an attributes object that does not exist (unless it is cma_c_null.)

Exceptions

cma_e_existence
cma_e_use_error