Instance Method

startAccessingSecurityScopedResource

In an app that has adopted App Sandbox, makes the resource pointed to by a security-scoped URL available to the app.

Declaration

- (BOOL)startAccessingSecurityScopedResource;

Return Value

YES if the request to access the resource succeeded; otherwise, NO.

Discussion

When you obtain a security-scoped URL, such as by resolving a security-scoped bookmark, you cannot immediately use the resource it points to. To make the resource available to your app, by way of adding its location to your app’s sandbox, call this method (or its Core Foundation equivalent, the CFURLStartAccessingSecurityScopedResource function) on the security-scoped URL.

If this method returns YES, then you must relinquish access as soon as you finish using the resource. Call the stopAccessingSecurityScopedResource method to relinquish access. When you call the stopAccessingSecurityScopedResource method, you immediately lose access to the resource in question.

See Also

Working with Bookmark Data

bookmarkDataWithContentsOfURL:error:

Initializes and returns bookmark data derived from an alias file pointed to by a specified URL.

bookmarkDataWithOptions:includingResourceValuesForKeys:relativeToURL:error:

Returns a bookmark for the URL, created with specified options and resource values.

resourceValuesForKeys:fromBookmarkData:

Returns the resource values for properties identified by a specified array of keys contained in specified bookmark data.

writeBookmarkData:toURL:options:error:

Creates an alias file on disk at a specified location with specified bookmark data.

stopAccessingSecurityScopedResource

In an app that adopts App Sandbox, revokes access to the resource pointed to by a security-scoped URL.

NSURLBookmarkFileCreationOptions

Options used when creating file bookmark data

NSURLBookmarkCreationOptions

Options used when creating bookmark data.

NSURLBookmarkResolutionOptions

Options used when resolving bookmark data.