CFRetainHeader: CFBase.h

Retains a Core Foundation object.

CFTypeRef CFRetain (
    CFTypeRef cf
);
cf

A generic reference of type CFTypeRef Pass a reference to a Core Foundation object that you want to retain.

function result

A generic reference of type CFTypeRef to a Core Foundation object. This is always the same reference as the parameter.

DISCUSSION

Retains a Core Foundation object by incrementing its retention count. You should retain a Core Foundation object when you receive it from elsewhere (that is, you did not create or copy it) and you want it to persist. If you retain a Core Foundation object you are responsible for releasing it (see the CFRelease function).


© 1999 Apple Computer, Inc. — (Last Updated 9/15/99)