NAME

om_delete - Deletes a private or service-generated object

SYNOPSIS

#include <xom.h>

OM_return_code om_delete(
        OM_object subject);

PARAMETERS

Input

subject
The 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

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

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

© 1990-1996, Transarc Corporation