Carbon


PMSetJobName

Header: PMCore.h Carbon status: Supported

Specifies the name of the print job.

OSStatus PMSetJobName (
    PMPrintSettings printSettings, 
    StringPtr name
);
Parameter descriptions
printSettings

A PMPrintSettings object.

name

The name to assign to the print job. This string will be used to name the spool file.

function result

A result code. A result code. See “Result Codes”. The result code kPMInvalidParameter is returned if you attempt to set the job name to an invalid file name or a null string.

DISCUSSION

PMSetJobNameCFString is recommended instead of PMSetJobName.

SPECIAL CONSIDERATIONS

Valid after calling PMBegin and creating a print settings object.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


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