---
title: "LSCopyDisplayNameForRef(_:_:)"
framework: coreservices
role: symbol
role_heading: Function
path: coreservices/1442576-lscopydisplaynameforref
---

# LSCopyDisplayNameForRef(_:_:)

Obtains the display name for an item with a file-system reference.

## Declaration

```swift
func LSCopyDisplayNameForRef(_ inRef: UnsafePointer<FSRef>!, _ outDisplayName: UnsafeMutablePointer<Unmanaged<CFString>?>!) -> OSStatus
```

## Parameters

- `inRef`: A pointer to a file-system reference designating the item whose display name is requested; see the File Manager Reference in the Carbon File Management Documentation for a description of the FSRef data type.
- `outDisplayName`: A pointer to a Core Foundation string object that, on return, will contain the item’s display name; see the CFString Reference in the Core Foundation Reference Documentation for a description of the CFStringRef data type. You are responsible for releasing this object.

## Return Value

Return Value A result code; see Result Codes.

## Discussion

Discussion The item’s display name is returned in the form in which it will appear on the user’s screen; it may be localized (for applications and folders), and it excludes the filename extension if the extension is set to be hidden and the Finder preference to always show extensions is not enabled. Version-Notes Thread-safe since Mac OS version 10.2.

## See Also

### Deprecated Functions

- [LSGetHandlerOptionsForContentType(_:)](coreservices/1445296-lsgethandleroptionsforcontenttyp.md)
- [LSSetHandlerOptionsForContentType(_:_:)](coreservices/1447588-lssethandleroptionsforcontenttyp.md)
- [LSCopyAllHandlersForURLScheme(_:)](coreservices/1443240-lscopyallhandlersforurlscheme.md)
- [LSCopyDefaultHandlerForURLScheme(_:)](coreservices/1441725-lscopydefaulthandlerforurlscheme.md)
- [LSGetApplicationForItem(_:_:_:_:)](coreservices/1446185-lsgetapplicationforitem.md)
- [LSGetApplicationForURL(_:_:_:_:)](coreservices/1445210-lsgetapplicationforurl.md)
- [LSGetApplicationForInfo(_:_:_:_:_:_:)](coreservices/1449928-lsgetapplicationforinfo.md)
- [LSCopyApplicationForMIMEType(_:_:_:)](coreservices/1448586-lscopyapplicationformimetype.md)
- [LSCanRefAcceptItem(_:_:_:_:_:)](coreservices/1442183-lscanrefacceptitem.md)
- [LSFindApplicationForInfo(_:_:_:_:_:)](coreservices/1449588-lsfindapplicationforinfo.md)
- [LSOpenApplication(_:_:)](coreservices/1447930-lsopenapplication.md)
- [LSOpenItemsWithRole(_:_:_:_:_:_:_:)](coreservices/1449783-lsopenitemswithrole.md)
- [LSOpenURLsWithRole(_:_:_:_:_:_:)](coreservices/1448184-lsopenurlswithrole.md)
- [LSOpenFSRef(_:_:)](coreservices/1445663-lsopenfsref.md)
- [LSOpenFromRefSpec(_:_:)](coreservices/1444466-lsopenfromrefspec.md)
- [LSCopyItemInfoForRef(_:_:_:)](coreservices/1445227-lscopyiteminfoforref.md)
- [LSCopyItemInfoForURL(_:_:_:)](coreservices/1445685-lscopyiteminfoforurl.md)
- [LSCopyDisplayNameForURL(_:_:)](coreservices/1446850-lscopydisplaynameforurl.md)
- [LSCopyKindStringForRef(_:_:)](coreservices/1448593-lscopykindstringforref.md)
- [LSCopyKindStringForURL(_:_:)](coreservices/1447481-lscopykindstringforurl.md)
- [LSCopyKindStringForTypeInfo(_:_:_:_:)](coreservices/1446207-lscopykindstringfortypeinfo.md)
- [LSCopyKindStringForMIMEType(_:_:)](coreservices/1442446-lscopykindstringformimetype.md)
- [LSCopyItemAttribute(_:_:_:_:)](coreservices/1445023-lscopyitemattribute.md)
- [LSCopyItemAttributes(_:_:_:_:)](coreservices/1446078-lscopyitemattributes.md)
- [LSGetExtensionInfo(_:_:_:)](coreservices/1446043-lsgetextensioninfo.md)
- [LSSetExtensionHiddenForRef(_:_:)](coreservices/1442766-lssetextensionhiddenforref.md)
- [LSSetExtensionHiddenForURL(_:_:)](coreservices/1443948-lssetextensionhiddenforurl.md)
- [LSRegisterFSRef(_:_:)](coreservices/1444582-lsregisterfsref.md)