Locates all known applications suitable for opening an item designated by the specified URL.
- macOS 10.3+
- Core Services
A Core Foundation URL reference designating the item for which all suitable applications are requested. See CFURL for a description of the
A bit mask specifying the applications’ role or roles with respect to the designated item. See
LSRolesfor a description of this mask. This parameter applies only to URLs with a scheme component of
file, and is ignored for all other schemes. If the role is unimportant, pass
An array of Core Foundation URL references, one for each application that can open the designated item with at least one of the specified roles. You are responsible for releasing the array object. If no suitable applications are found in the Launch Services database, the function will return
In macOS 10.15 and later, the returned array is sorted with the first element containing the best available application for opening the specified URL. Prior to macOS 10.15, the order of elements in the array was undefined.
If the item URL’s scheme is
file (designating either a file or a directory), the selection of suitable applications is based on the designated item’s filename extension, file type, and creator signature, along with the role specified by the
in parameter. Otherwise, the selection is based on the URL scheme (such as
Thread-safe since macOS 10.3.