LSFindApplicationForInfo(_:_:_:_:_:)

Declaration

func LSFindApplicationForInfo(_ inCreator: OSType, _ inBundleID: CFString!, _ inName: CFString!, _ outAppRef: UnsafeMutablePointer<FSRef>!, _ outAppURL: UnsafeMutablePointer<Unmanaged<CFURL>?>!) -> OSStatus

Parameters

• inCreator:

  The creator signature to consider. Comparison of creator signatures is case-sensitive. Pass kLSUnknownCreator if the application’s creator signature is unimportant.

• inBundleID:

  A Core Foundation string object specifying the bundle ID to consider; see the CFString Reference in the Core Foundation Reference Documentation for a description of the CFStringRef data type. Comparison of bundle IDs is case-insensitive. Pass NULL if the application’s bundle ID is unimportant.

• inName:

  A Core Foundation string object specifying the filename to consider; see the CFString Reference in the Core Foundation Reference Documentation for a description of the CFStringRef data type. The string must include any extension (such as '.app') that is part of the filename. Comparison of filenames is case-insensitive. Pass NULL if the application’s filename is unimportant.

• outAppRef:

  A pointer to a file-system reference that, on return, will identify the requested application; see the File Manager Reference in the Carbon File Management Documentation for a description of the FSRef data type. Pass NULL if you are not interested in identifying the application in this form; however, this parameter and outAppURL cannot both be NULL.

• outAppURL:

  A pointer to a Core Foundation URL reference that, on return, will identify the requested application; see the CFURL Reference in the Core Foundation Reference Documentation for a description of the CFURLRef data type. Pass NULL if you are not interested in identifying the application in this form; however, this parameter and outAppRef cannot both be NULL.

  Despite the absence of the word Copy in its name, this function retains the URL reference object on your behalf; you are responsible for releasing this object.

Return Value

A result code; see Result Codes. If no suitable application is found in the Launch Services database, the function will return the result code kLSApplicationNotFoundErr.

Discussion

You can request any combination of one, two, or all three of the characteristics specified by the inCreator, inBundleID, and inName parameters; at least one of these characteristics must be supplied. If more than one application is found matching the specified characteristics, Launch Services chooses one in the same manner as when locating the preferred application for opening an item.

Version-Notes

Thread-safe since Mac OS version 10.2.

See Also

Deprecated Functions

• LSGetHandlerOptionsForContentType(_:)
• LSSetHandlerOptionsForContentType(_:_:)
• LSCopyAllHandlersForURLScheme(_:)
• LSCopyDefaultHandlerForURLScheme(_:)
• LSGetApplicationForItem(_:_:_:_:)
• LSGetApplicationForURL(_:_:_:_:)
• LSGetApplicationForInfo(_:_:_:_:_:_:)
• LSCopyApplicationForMIMEType(_:_:_:)
• LSCanRefAcceptItem(_:_:_:_:_:)
• LSOpenApplication(_:_:)
• LSOpenItemsWithRole(_:_:_:_:_:_:_:)
• LSOpenURLsWithRole(_:_:_:_:_:_:)
• LSOpenFSRef(_:_:)
• LSOpenFromRefSpec(_:_:)
• LSCopyItemInfoForRef(_:_:_:)
• LSCopyItemInfoForURL(_:_:_:)
• LSCopyDisplayNameForRef(_:_:)
• LSCopyDisplayNameForURL(_:_:)
• LSCopyKindStringForRef(_:_:)
• LSCopyKindStringForURL(_:_:)
• LSCopyKindStringForTypeInfo(_:_:_:_:)
• LSCopyKindStringForMIMEType(_:_:)
• LSCopyItemAttribute(_:_:_:_:)
• LSCopyItemAttributes(_:_:_:_:)
• LSGetExtensionInfo(_:_:_:)
• LSSetExtensionHiddenForRef(_:_:)
• LSSetExtensionHiddenForURL(_:_:)
• LSRegisterFSRef(_:_:)