Carbon


ReleaseIconRef

Header: Icons.h Carbon status: Supported

Decrements the reference count for an IconRef.

OSErr ReleaseIconRef (
    IconRef theIconRef
);
Parameter descriptions
theIconRef

An IconRef whose reference count you wish to decrement.

function result

A result code.

DISCUSSION

When an IconRef’s reference count reaches 0, all memory allocated for the IconRef is marked as disposable. Any subsequent attempt to use the IconRef returns a result code of -2580 (invalidIconRefErr).

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)