Deletes a reference object.

#include <rt.h> 

BOOLEAN DeleteRtReferenceObject(
    RTHANDLE hRef
);

Parameters

hRef

The handle for an existing reference object.

Remarks

If the object indicated by the reference object is a reference-counted object then it will have its reference count decremented and the object will be deleted if the count reaches zero. If the object is owned by the calling process then the object will be deleted. In all other cases only the reference object will be deleted and the referred-to object will not 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.

Requirements