Function

LSCanURLAcceptURL

Tests whether an application can accept (open) an item designated by URL.

Declaration

OSStatus LSCanURLAcceptURL(CFURLRef inItemURL, CFURLRef inTargetURL, LSRolesMask inRoleMask, LSAcceptanceFlags inFlags, Boolean *outAcceptsItem);

Parameters

inItemURL

A Core Foundation URL reference designating the source item (the item to test for acceptance by the target application); see the CFURL Reference in the Core Foundation Reference Documentation for a description of the CFURLRef data type.

inTargetURL

A Core Foundation URL reference designating the target application; see the CFURL Reference in the Core Foundation Reference Documentation for a description of the CFURLRef data type. The URL must have scheme file and contain a valid path to an application file or application bundle.

inRolesMask

A bit mask specifying the target application’s desired role or roles with respect to the source item; see LSRolesMask for 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 kLSRolesAll.

inFlags

Flags specifying behavior to observe during the acceptance test; see LSAcceptanceFlags for a description of these flags.

outAcceptsItem

A pointer to a Boolean value that, on return, will indicate whether the target application can accept the source item with at least one of the specified roles.

Return Value

A result code; see Result Codes.

Discussion

If the item URL’s scheme is file (designating either a file or a directory), the acceptance test is based on the designated item’s filename extension, file type, and creator signature, along with the role specified by the inRolesMask parameter; otherwise, it is based on the URL scheme (such as http, ftp, or mailto).

Version-Notes

Thread-safe since Mac OS version 10.2.

See Also

Locating an Application

LSCopyDefaultApplicationURLForURL

Returns the application used to open an item.

LSGetApplicationForItem

Locates the preferred application for opening an item designated by file-system reference.

Deprecated
LSGetApplicationForURL

Locates the preferred application for opening an item designated by URL.

Deprecated
LSCopyDefaultApplicationURLForContentType

Returns the application used to open a content type (UTI).

LSGetApplicationForInfo

Locates the preferred application for opening items with a specified file type, creator signature, filename extension, or any combination of these characteristics.

Deprecated
LSCopyApplicationForMIMEType

Locates the preferred application for opening items with a specified MIME type.

Deprecated
LSCopyApplicationURLsForURL

Locates all known applications suitable for opening an item designated by the specified URL.

LSCanRefAcceptItem

Tests whether an application can accept (open) an item designated by file-system reference.

Deprecated
LSCopyApplicationURLsForBundleIdentifier

Locates all URLs for applications that correspond to the specified bundle identifier.

LSFindApplicationForInfo

Locates an application with a specified creator signature, bundle ID, filename, or any combination of these characteristics.

Deprecated