LSCopyKindStringForURL(_:_:)

Obtains the kind string for an item with a URL.

Declaration

func LSCopyKindStringForURL(_ inURL: CFURL!, _ outKindString: UnsafeMutablePointer<Unmanaged<CFString>?>!) -> OSStatus

Parameters

inURL:
A Core Foundation URL reference designating the item whose kind string is requested; see the CFURL Reference in the Core Foundation Reference Documentation for a description of the CFURLRef data type.
outKindString:
A pointer to a Core Foundation string object that, on return, will contain the item’s kind string; 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

A result code; see Result Codes.

Discussion

The kind string (which may be localized) is obtained from the item’s preferred application, if one is found in the Launch Services database; otherwise, a more generic kind string is chosen. For example, the kind string might be FrameMakerDocument, or just Document if the item is a document for which no application is found. If the item URL’s scheme is file (designating either a file or a directory), the selection of the preferred application is based on the designated item’s filename extension, file type, and creator signature; otherwise, it is based on the URL scheme (such as http, ftp, or mailto).

Version-Notes

Thread-safe since Mac OS version 10.2.