---
title: PMSetJobNameCFString
framework: Application Services
role: pseudoSymbol
platforms: []
path: applicationservices/core_printing/1805515-pmsetjobnamecfstring
---

# PMSetJobNameCFString

Specifies the name of a print job.

## Declaration

```occ
OSStatus PMSetJobNameCFString (
   PMPrintSettings printSettings,
   CFStringRef name
);
```

## Parameters

- `printSettings`: The print settings object whose job name you want to set.
- `name`: The new name for the print job.

## Return Value

A result code. See [Result Codes](../core_printing.md). The result code `kPMInvalidParameter` is returned if you pass `NULL` or an empty string in the `name` parameter.

## Overview

You should call this function before you open the Print dialog.

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

- [PMGetPrintSettingsExtendedData](1805488-pmgetprintsettingsextendeddata.md)
- [PMSetPrintSettingsExtendedData](1805491-pmsetprintsettingsextendeddata.md)
- [PMGetFirstPage](../1460271-pmgetfirstpage.md)
- [PMSetFirstPage](../1461519-pmsetfirstpage.md)
- [PMGetLastPage](../1462747-pmgetlastpage.md)
- [PMSetLastPage](../1463595-pmsetlastpage.md)
- [PMGetPageRange](../1459324-pmgetpagerange.md)
- [PMSetPageRange](../1462294-pmsetpagerange.md)
- [PMPrintSettingsGetJobName](../1459233-pmprintsettingsgetjobname.md)
- [PMPrintSettingsSetJobName](../1460149-pmprintsettingssetjobname.md)
- [PMGetCopies](../1464480-pmgetcopies.md)
- [PMSetCopies](../1463804-pmsetcopies.md)
- [PMGetCollate](../1464492-pmgetcollate.md)
- [PMSetCollate](../1463223-pmsetcollate.md)
- [PMGetDuplex](../1458921-pmgetduplex.md)
- [PMSetDuplex](../1462000-pmsetduplex.md)
- [PMPrintSettingsGetValue](../1460602-pmprintsettingsgetvalue.md)
- [PMPrintSettingsSetValue](../1461697-pmprintsettingssetvalue.md)
- [PMPrintSettingsCopyAsDictionary](../1459088-pmprintsettingscopyasdictionary.md)
- [PMPrintSettingsCopyKeys](../1462730-pmprintsettingscopykeys.md)
- [PMGetJobNameCFString](1805513-pmgetjobnamecfstring.md)