Carbon


PMRelease

Header: PMCore.h Carbon status: Supported

Decrements a printing object’s reference count.

OSStatus PMRelease (
    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

Your application should use the PMRelease function to release any printing objects it creates. When an object’s reference count reaches 0, the object is deallocated.

To terminate a printing session created with PMCreateSession, pass the associated PMPrintSession object to PMRelease.

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.

CARBON NOTES

PMRelease is equivalent to the Classic Printing Manager function PrClose when the parameter is a PMPrintSession object and its reference count is zero.


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