Home  /  Autodocs  /  utility.library

NAME

AttemptRemNamedObject
attempt to remove a named object. (V39)

SYNOPSIS

result = AttemptRemNamedObject(object);
D0 A0

LONG AttemptRemNamedObject(struct NamedObject *);

FUNCTION

Attempts to remove an object from whatever NameSpace it's in. You must have found the object first (in order to get a use count) before trying to remove it. If the object is in use or is in the process of being removed, this function will return a failure code. If the object is fully removed, the object will then be available to be FreeNamedObject().

INPUTS

object
the object to attempt to remove The object must be valid

RESULT

success
FALSE if object is still in use (somewhere) TRUE if object was removed

SEE ALSO

RemNamedObject(), AddNamedObject(), ReleaseNamedObject()