Carbon


PMRetain

Header: PMCore.h Carbon status: Supported

Increments a printing object’s reference count.

OSStatus PMRetain (
    PMObject object
);
Parameter descriptions
object

A Carbon Printing Manager object, such as a PMPrintSession, PMPageFormat, or PMPrintSettings object.

function result

A result code. A result code. See “Result Codes”.

DISCUSSION

You can use the PMRetain function to increment a printing object’s reference count, so that multiple threads can use the object without the risk of another thread deallocating the object.s

SPECIAL CONSIDERATIONS

Valid after creating a printing object.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.1 and later when CarbonLib 1.1 or later is present.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)