Carbon


PMGetDestination

Header: PMCore.h Carbon status: Supported

Obtains the destination of a print job.

OSStatus PMGetDestination (
    PMPrintSettings printSettings, 
    PMDestinationType *destType, 
    CFURLRef *fileURL
);
Parameter descriptions
printSettings

A PMPrintSettings object.

destType

On return, the destination for the print job (printer, file, or fax). See “DestinationType Constants” for a list of possible return values.

fileURL

On return, the location of the print job destination.

function result

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

DISCUSSION

For print jobs that are sent to disk, as opposed a printer, you can use this function to obtain the location of the destination file.

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.1 and later when CarbonLib 1.1 or later is present.


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