Deletes a reference object.

#include <rt.h> 

BOOLEAN DeleteRtReferenceObject(
    RTHANDLE hRef
);

Parameters

hRef

The handle for an existing reference object.

Remarks

The reference object refers to a real object ("the target object").

If the target object is a reference-counted object:

• the target object's reference count will be decremented
• if the resulting reference count is zero, the target object will be deleted, and so will the reference object.

If the target object is not a reference-counted object:

• If the target object is owned by the calling process then the target object and the reference object will be deleted.
• if the target object is not owned by the calling process, only the reference object will be deleted.

Return Values

TRUE

Success.

FALSE

Failure. The function sets GetLastRtError to one of these values:

E_TYPE	The handle does not indicate a reference object.
E_EXIST	The handle does not refer to a valid object, OR The remote object indicated by the reference object does not exist.
E_RESOURCE_LIMIT	Insufficient resources are available to signal the remote node.

Requirements