Name

om_delete - Deletes a private or service-generated object

Synopsis

#include <xom.h> OM_return_code om_delete(
OM_object subject);

Parameters

Input

subjectThe object to be deleted. 

Description

The om_delete() function deletes a service-generated public object or makes a private object inaccessible.  It is not intended for use on client-generated public objects. 

If applied to a service-generated public object, the function deletes the object and releases any resources associated with the object, including the space occupied by descriptors and attribute values.  The function is applied recursively to any public subobjects.  This does not affect any private subobjects. 

If applied to a private object, the function makes the object inaccessible.  Any existing object handles for the object are invalidated.  The function is applied recursively to any private subobjects. 

Return Values

The following describes a partial list of messages (or errors) that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

OM_return_code
Indicates whether the function succeeded and, if not, why not.  If the function is successful, the value of OM_return_code is set to OM_SUCCESS; if the function fails, it has one of the error values listed in this reference page. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

       •OM_FUNCTION_INTERRUPTED

       •OM_MEMORY_INSUFFICIENT

       •OM_NETWORK_ERROR

       •OM_NO_SUCH_OBJECT

       •OM_NO_SUCH_SYNTAX

       •OM_NO_SUCH_TYPE

       •OM_NOT_THE_SERVICES

       •OM_PERMANENT_ERROR

       •OM_POINTER_INVALID

       •OM_SYSTEM_ERROR

       •OM_TEMPORARY_ERROR