Returns a new URL made by resolving bookmark data.
- iOS 4.0+
- macOS 10.6+
- tvOS 9.0+
- watchOS 2.0+
The allocator to use to allocate memory for the new
kto use the current default allocator.
The bookmark data the URL is derived from.
Options taken into account when resolving the bookmark data.
To resolve a security-scoped bookmark to support App Sandbox, you must include (by way of bitwise
ORoperators with any other options in this parameter) the
Bookmark Resolution With Security Scope
The base URL that the bookmark data is relative to. Can be
If you are resolving a security-scoped bookmark to obtain a security-scoped URL, use this parameter as follows:
To resolve an app-scoped bookmark, use a value of
To resolve a document-scoped bookmark, use the absolute path (despite this parameter’s name) to the document from which you retrieved the bookmark.
Properties To Include
An array of resource properties to include when creating the URL. Can be
true, the bookmark data is stale.
The error that occurred in the case that the URL cannot be created.
A new URL made by resolving
NULL if an error occurs.
To obtain a security-scoped URL from a security-scoped bookmark, call this method using the
cfurl option. In addition, to use security scope, you must first have enabled the appropriate entitlements for your app, as described in Enabling Security-Scoped Bookmark and URL Access.
To then obtain access to the file-system resource pointed to by a security-scoped URL (in other words, to bring the resource into your app’s sandbox), call the
CFURLStart function (or its Cocoa equivalent) on the URL.
For an app-scoped bookmark, no sandboxed app other than the one that created the bookmark can obtain access to the file-system resource that the URL (obtained from the bookmark) points to.
For a document-scoped bookmark, any sandboxed app that has access to the bookmark data itself, and has access to the document that owns the bookmark, can obtain access to the resource.