Function

LSCopyItemAttributes

Obtains multiple item attribute values as a dictionary.

Declaration

OSStatus LSCopyItemAttributes(const FSRef *inItem, LSRolesMask inRoles, CFArrayRef inAttributeNames, CFDictionaryRef *outValues);

Parameters

inItem

The FSRef of the item to query.

inRoles

The roles. When obtaining attributes related to document binding (such as kLSItemRoleHandlerDisplayName), at least one of the roles must be provided by the application selected. Pass kLSRolesAll if any role is acceptable.

inAttributeNames

A CFArrayRef for an array containing the attribute names to copy. For possible values, see Item Attribute Constants.

outValues

On return, a pointer a CFDictionaryRef for a dictionary whose keys are the attribute names specified by the inAttributeNames parameter and whose values are the attribute’s values. The CFTypeID of each value in the dictionary varies by attribute. See Item Attribute Constants for the data type of each value. If the item does not have a specified attribute, the key for the attribute is not in the dictionary.

Return Value

A result code; see Result Codes.

Discussion

Thread-safe since OS X v10.4.

See Also

Obtaining Information About an Item

LSCopyItemInfoForRef

Obtains requested information about an item designated by file-system reference.

Deprecated
LSCopyItemInfoForURL

Obtains requested information about an item designated by URL.

Deprecated
LSCopyDisplayNameForRef

Obtains the display name for an item designated by file-system reference.

Deprecated
LSCopyDisplayNameForURL

Obtains the display name for an item designated by URL.

Deprecated
LSCopyKindStringForRef

Obtains the kind string for an item designated by file-system reference.

Deprecated
LSCopyKindStringForURL

Obtains the kind string for an item designated by URL.

Deprecated
LSCopyKindStringForTypeInfo

Obtains a kind string for items with a specified file type, creator signature, filename extension, or any combination of these characteristics.

Deprecated
LSCopyKindStringForMIMEType

Obtains the kind string for a specified MIME type.

Deprecated
LSCopyItemAttribute

Obtains the value of an item’s attribute.

Deprecated