Function

LSCopyItemInfoForURL

Obtains requested information about an item designated by URL.

Declaration

OSStatus LSCopyItemInfoForURL(CFURLRef inURL, LSRequestedInfo inWhichInfo, LSItemInfoRecord *outItemInfo);

Parameters

inFileURL

A Core Foundation URL reference designating the item about which information is requested; 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 either a file or a directory.

inWhichInfo

Flags specifying what information to obtain; see LSRequestedInfo for a description of these flags.

outItemInfo

A pointer to an item-information record that, on return, will contain the requested information; see LSItemInfoRecord for a description of this structure.

If you request the item’s filename extension (field extension of the item-information record, requested by flag kLSRequestExtension), you are responsible for releasing the Core Foundation string object in which the extension is returned.

Return Value

A result code; see Result Codes.

Discussion

The information obtained about an item can include its filename extension, file type, creator signature, and various item-information flags (indicating, for example, whether the item is an application, or whether it has a hidden extension); see LSItemInfoFlags for a description of these flags.

Version-Notes

Thread-safe since Mac OS version 10.2.

See Also

Obtaining Information About an Item

LSCopyItemInfoForRef

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

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
LSCopyItemAttributes

Obtains multiple item attribute values as a dictionary.

Deprecated