Document Revision History

This table describes the changes to CFURL Reference.

2013-12-16Added information about the types allowed in property values passed to CFURLCreateBookmarkData.
2013-10-22Clarified percent escaping behavior of CFURLCopyStrictPath.
2013-08-08Added property keys related to iCloud.

Removed some content about security-scoped bookmarks from the Introduction and added a link to the definitive discussion for that information, the “Security-Scoped Bookmarks and Persistent Resource Access” in App Sandbox Design Guide section in App Sandbox Design Guide.


Added information in the Introduction about copying security-scoped URLs.


Added a description for the kCFURLIsExcludedFromBackupKey constant.

2012-02-16Added descriptions for APIs that support security-scoped bookmarks, used in apps that adopt App Sandbox.

Expanded the Overview section with new content about security-scoped bookmarks and security-scoped URLs.


Added descriptions of two new functions in OS X v10.7.3: CFURLStartAccessingSecurityScopedResource and CFURLStopAccessingSecurityScopedResource.


Added descriptions of new constants in OS X v10.7.3: kCFURLBookmarkCreationWithSecurityScope, kCFURLBookmarkCreationSecurityScopeAllowOnlyReadAccess, and kCFURLBookmarkResolutionWithSecurityScope.


Updated descriptions of functions whose behavior changed in OS X v10.7.3 to support App Sandbox: CFURLCreateBookmarkData and CFURLCreateByResolvingBookmarkData.

2011-04-29Added file property keys new in OS X v10.7.
2010-09-01Added availability information for iOS.
2009-08-07Added functions and constants for the bookmark data API new in OS X v10.6.
2009-02-04Corrected typos.
2008-07-11Clarified the description of the CFURLGetBytes function.
2006-01-10Clarified the behavior of the functions CFURLCreateStringByAddingPercentEscapes and CFURLGetFSRef.
2005-12-06Made minor changes to clarify memory management rules.
2005-11-09Removed reference to retired document.
2005-10-04 Corrected minor typographic errors.
2005-07-07 Clarified implementations of CFURLCanBeDecomposed and CFURLCreateCopyAppendingPathComponent, and description of CFURLCopyPathExtension.
2005-04-29 Moved Introduction to new Introduction page.

Clarification of return values for CFURLCopyLastPathComponent.


Added descriptions of new OS X v10.3 API.


First version of this document.