Contents

LSCanRefAcceptItem(_:_:_:_:_:)

Tests whether an app can accept (open) an item with a file-system reference.

Declaration

func LSCanRefAcceptItem(_ inItemFSRef: UnsafePointer<FSRef>!, _ inTargetRef: UnsafePointer<FSRef>!, _ inRoleMask: LSRolesMask, _ inFlags: LSAcceptanceFlags, _ outAcceptsItem: UnsafeMutablePointer<DarwinBoolean>!) -> OSStatus

Parameters

  • inItemFSRef:

    A pointer to a file-system reference designating the source item (the item to test for acceptance by the target application); see the File Manager Reference in the Carbon File Management Documentation for a description of the FSRef data type.

  • inTargetFSRef:

    A pointer to a file-system reference designating the target application; see the File Manager Reference in the Carbon File Management Documentation for a description of the FSRef data type.

  • 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. 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

Thread-safe since Mac OS version 10.2.

See Also

Deprecated Functions