Stores the value of a setting in a print settings object.
- macOS 10.4+
The print settings object you want to update.
A string constant that specifies the key for the desired setting. Some keys are currently defined in
PMTicket; other keys are user-defined.
A Core Foundation object that corresponds to the specified key. If you pass
NULL, any existing setting for the specified key is removed.
true, the item being set should be locked; otherwise,
false. Currently, you should always pass
A result code. See Result Codes.
This function makes it possible to add, change, or remove print settings directly. Print settings are stored as key-value pairs. The keys are Core Foundation strings and the corresponding values are Core Foundation objects.
You can use this function to store user-defined data in a print settings object. You should make sure that the custom keys you define for your private data do not conflict with any other keys in the object. Each data item you store needs to be a Core Foundation object. You can use the function
PMPrint to retrieve your private data.
If you call this function after initiating a print job (for example, by calling PMSessionBeginCGDocument), the change is ignored for the current job.