---
title: "PMSetCopies(_:_:_:)"
framework: applicationservices
role: symbol
role_heading: Function
path: applicationservices/1463804-pmsetcopies
---

# PMSetCopies(_:_:_:)

Sets the initial value for the number of copies to be printed.

## Declaration

```swift
func PMSetCopies(_ printSettings: PMPrintSettings, _ copies: UInt32, _ lock: Bool) -> OSStatus
```

## Parameters

- `printSettings`: The print settings object you want to initialize.
- `copies`: The initial value of the number of copies to print.
- `lock`: The lock state of the setting. Locking is not supported at this time.

## Return Value

Return Value A result code. See Result Codes.

## Discussion

Discussion If you call this function after initiating a print job, the change is ignored for the current job.

## See Also

### Accessing Data in Print Settings Objects

- [PMGetFirstPage(_:_:)](applicationservices/1460271-pmgetfirstpage.md)
- [PMSetFirstPage(_:_:_:)](applicationservices/1461519-pmsetfirstpage.md)
- [PMGetLastPage(_:_:)](applicationservices/1462747-pmgetlastpage.md)
- [PMSetLastPage(_:_:_:)](applicationservices/1463595-pmsetlastpage.md)
- [PMGetPageRange(_:_:_:)](applicationservices/1459324-pmgetpagerange.md)
- [PMSetPageRange(_:_:_:)](applicationservices/1462294-pmsetpagerange.md)
- [PMPrintSettingsGetJobName(_:_:)](applicationservices/1459233-pmprintsettingsgetjobname.md)
- [PMPrintSettingsSetJobName(_:_:)](applicationservices/1460149-pmprintsettingssetjobname.md)
- [PMGetCopies(_:_:)](applicationservices/1464480-pmgetcopies.md)
- [PMGetCollate(_:_:)](applicationservices/1464492-pmgetcollate.md)
- [PMSetCollate(_:_:)](applicationservices/1463223-pmsetcollate.md)
- [PMGetDuplex(_:_:)](applicationservices/1458921-pmgetduplex.md)
- [PMSetDuplex(_:_:)](applicationservices/1462000-pmsetduplex.md)
- [PMPrintSettingsGetValue(_:_:_:)](applicationservices/1460602-pmprintsettingsgetvalue.md)
- [PMPrintSettingsSetValue(_:_:_:_:)](applicationservices/1461697-pmprintsettingssetvalue.md)
- [PMPrintSettingsCopyAsDictionary(_:_:)](applicationservices/1459088-pmprintsettingscopyasdictionary.md)
- [PMPrintSettingsCopyKeys(_:_:)](applicationservices/1462730-pmprintsettingscopykeys.md)