Carbon


PMGetCopies

Header: PMCore.h Carbon status: Supported

Obtains the number of copies that the user has requested to be printed.

OSStatus PMGetCopies (
    PMPrintSettings printSettings, 
    UInt32 *copies
);
Parameter descriptions
printSettings

A PMPrintSettings object.

copies

On return, the number of copies requested by the user.

function result

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

SPECIAL CONSIDERATIONS

Before using this function you must call PMSessionValidatePrintSettings or PMValidatePrintSettings to ensure that the print settings object is valid.

Valid within a printing session after creating a print settings object.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.

CARBON NOTES

The PMGetCopies function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and obtains information formerly stored in the iCopies field of the Printing Manager structure TPrJob.


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