checkPromisedItemIsReachableAndReturnError(_:)
Returns whether the promised item can be reached.
Declaration
func checkPromisedItemIsReachableAndReturnError(_ error: NSErrorPointer) -> BoolParameters
- error:
The error that occurred when the promised item could not be reached.
Return Value
Discussion
This method behaves identically to checkResourceIsReachableAndReturnError(_:), but works on promised items. A promised item is not guaranteed to have its contents in the file system until you use a file coordinator to perform a coordinated read on its URL, which causes the contents to be downloaded or otherwise generated. Promised item URLs are returned by various APIs, including:
A metadata query using either the NSMetadataQueryUbiquitousDataScope or NSMetadataQueryUbiquitousDocumentsScope scopes
The contents of the directory returned by the file manager’s
URLForUbiquitousContainerIdentifier:The URL inside the accessor block of a coordinated read or write operation that used the immediatelyAvailableMetadataOnly, forDeleting, forMoving, or contentIndependentMetadataOnly options
You must use this method instead of checkResourceIsReachableAndReturnError for any URLs returned by these methods.