URL Loading System Error Codes
These values are returned as the error code property of an NSError
object with the domain “NSURLErrorDomain”.
NSError
codes in the Cocoa error domain.
enum { NSFileNoSuchFileError = 4, NSFileLockingError = 255, NSFileReadUnknownError = 256, NSFileReadNoPermissionError = 257, NSFileReadInvalidFileNameError = 258, NSFileReadCorruptFileError = 259, NSFileReadNoSuchFileError = 260, NSFileReadInapplicableStringEncodingError = 261, NSFileReadUnsupportedSchemeError = 262, NSFileReadTooLargeError = 263, NSFileReadUnknownStringEncodingError = 264, NSFileWriteUnknownError = 512, NSFileWriteNoPermissionError = 513, NSFileWriteInvalidFileNameError = 514, NSFileWriteInapplicableStringEncodingError = 517, NSFileWriteUnsupportedSchemeError = 518, NSFileWriteOutOfSpaceError = 640, NSFileWriteVolumeReadOnlyError = 642m NSKeyValueValidationError = 1024, NSFormattingError = 2048, NSUserCancelledError = 3072, NSFileErrorMinimum = 0, NSFileErrorMaximum = 1023, NSValidationErrorMinimum = 1024, NSValidationErrorMaximum = 2047, NSFormattingErrorMinimum = 2048, NSFormattingErrorMaximum = 2559, NSPropertyListReadCorruptError = 3840, NSPropertyListReadUnknownVersionError = 3841, NSPropertyListReadStreamError = 3842, NSPropertyListWriteStreamError = 3851, NSPropertyListErrorMinimum = 3840, NSPropertyListErrorMaximum = 4095 NSExecutableErrorMinimum = 3584, NSExecutableNotLoadableError = 3584, NSExecutableArchitectureMismatchError = 3585, NSExecutableRuntimeMismatchError = 3586, NSExecutableLoadError = 3587, NSExecutableLinkError = 3588, NSExecutableErrorMaximum = 3839, }Loading System Error Codes
These values are returned as the error code property of an NSError object with the domain “NSURLErrorDomain”.
enum
{
NSURLErrorUnknown = -1,
NSURLErrorCancelled = -999,
NSURLErrorBadURL = -1000,
NSURLErrorTimedOut = -1001,
NSURLErrorUnsupportedURL = -1002,
NSURLErrorCannotFindHost = -1003,
NSURLErrorCannotConnectToHost = -1004,
NSURLErrorDataLengthExceedsMaximum = -1103,
NSURLErrorNetworkConnectionLost = -1005,
NSURLErrorDNSLookupFailed = -1006,
NSURLErrorHTTPTooManyRedirects = -1007,
NSURLErrorResourceUnavailable = -1008,
NSURLErrorNotConnectedToInternet = -1009,
NSURLErrorRedirectToNonExistentLocation = -1010,
NSURLErrorBadServerResponse = -1011,
NSURLErrorUserCancelledAuthentication = -1012,
NSURLErrorUserAuthenticationRequired = -1013,
NSURLErrorZeroByteResource = -1014,
NSURLErrorCannotDecodeRawData = -1015,
NSURLErrorCannotDecodeContentData = -1016,
NSURLErrorCannotParseResponse = -1017,
NSURLErrorInternationalRoamingOff = -1018,
NSURLErrorCallIsActive = -1019,
NSURLErrorDataNotAllowed = -1020,
NSURLErrorRequestBodyStreamExhausted = -1021,
NSURLErrorFileDoesNotExist = -1100,
NSURLErrorFileIsDirectory = -1101,
NSURLErrorNoPermissionsToReadFile = -1102,
NSURLErrorSecureConnectionFailed = -1200,
NSURLErrorServerCertificateHasBadDate = -1201,
NSURLErrorServerCertificateUntrusted = -1202,
NSURLErrorServerCertificateHasUnknownRoot = -1203,
NSURLErrorServerCertificateNotYetValid = -1204,
NSURLErrorClientCertificateRejected = -1205,
NSURLErrorClientCertificateRequired = -1206,
NSURLErrorCannotLoadFromNetwork = -2000,
NSURLErrorCannotCreateFile = -3000,
NSURLErrorCannotOpenFile = -3001,
NSURLErrorCannotCloseFile = -3002,
NSURLErrorCannotWriteToFile = -3003,
NSURLErrorCannotRemoveFile = -3004,
NSURLErrorCannotMoveFile = -3005,
NSURLErrorDownloadDecodingFailedMidStream = -3006,
NSURLErrorDownloadDecodingFailedToComplete = -3007
}
Constants
NSURLErrorUnknown = -1,
NSURLErrorUnknown
Returned when the URL Loading system encounters an error that it cannot interpret.
This can occur when an error originates from a lower level framework or library. Whenever this error code is received, it is a bug, and should be reported to Apple.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCancelled = -999,
Returned when an asynchronous load is canceled.
A Web Kit framework delegate will receive this error when it performs a cancel operation on a loading resource. Note that an NSURLConnection or NSURLDownloaddelegate will not receive this error if the download is canceled.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorBadURL = -1000,
Returned when a URL is sufficiently malformed that a URL request cannot be initiated
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorTimedOut = -1001,
Returned when an asynchronous operation times out.
NSURLConnection will send this error to its delegate when the timeoutInterval in NSURLRequest expires before a load can complete.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorUnsupportedURL = -1002,
Returned when a properly formed URL cannot be handled by the framework.
The most likely cause is that there is no available protocol handler for the URL.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotFindHost = -1003,
Returned when the host name for a URL cannot be resolved.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotConnectToHost = -1004,
Returned when an attempt to connect to a host has failed.
This can occur when a host name resolves, but the host is down or may not be accepting connections on a certain port.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorDataLengthExceedsMaximum = -1103,
Returned when the length of the resource data exceeds the maximum allowed.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorNetworkConnectionLost = -1005,
Returned when a client or server connection is severed in the middle of an in-progress load.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorDNSLookupFailed = -1006,
See NSURLErrorCannotFindHost
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorHTTPTooManyRedirects = -1007,
Returned when a redirect loop is detected or when the threshold for number of allowable redirects has been exceeded (currently 16).
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorResourceUnavailable = -1008,
Returned when a requested resource cannot be retrieved.
Examples are “file not found”, and data decoding problems that prevent data from being processed correctly.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorNotConnectedToInternet = -1009,
Returned when a network resource was requested, but an internet connection is not established and cannot be established automatically, either through a lack of connectivity, or by the user's choice not to make a network connection automatically.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorRedirectToNonExistentLocation = -1010,
Returned when a redirect is specified by way of server response code, but the server does not accompany this code with a redirect URL.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorBadServerResponse
Returned when the URL Loading system receives bad data from the server.
This is equivalent to the “500 Server Error” message sent by HTTP servers.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorUserCancelledAuthentication
Returned when an asynchronous request for authentication is cancelled by the user.
This is typically incurred by clicking a “Cancel” button in a username/password dialog, rather than the user making an attempt to authenticate.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorUserAuthenticationRequired
Returned when authentication is required to access a resource.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorZeroByteResource
Returned when a server reports that a URL has a non-zero content length, but terminates the network connection “gracefully” without sending any data.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotDecodeRawData
Returned when content data received during an NSURLConnection request cannot be decoded for a known content encoding.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotDecodeContentData
Returned when content data received during an NSURLConnection request has an unknown content encoding.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotParseResponse
Returned when a response to an NSURLConnection request cannot be parsed.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorInternationalRoamingOff
Returned when a connection would require activating a data context while roaming, but international roaming is disabled.
Available in iOS 3.0 and later.
Declared in NSURLError.h.
NSURLErrorCallIsActive
Returned when a connection is attempted while a phone call is active on a network that does not support simultaneous phone and data communication (EDGE or GPRS).
Available in iOS 3.0 and later.
Declared in NSURLError.h.
NSURLErrorDataNotAllowed
Returned when the cellular network disallows a connection.
Available in iOS 3.0 and later.
Declared in NSURLError.h.
NSURLErrorRequestBodyStreamExhausted
Returned when a body stream is needed but the client does not provide one. This impacts clients on iOS that send a POST request using a body stream but do not implement the NSURLConnection delegate method connection:needNewBodyStream.
Available in iOS 3.0 and later.
Declared in NSURLError.h.
NSURLErrorFileDoesNotExist
Returned when a file does not exist.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorFileIsDirectory
Returned when a request for an FTP file results in the server responding that the file is not a plain file, but a directory.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorNoPermissionsToReadFile
Returned when a resource cannot be read due to insufficient permissions.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorSecureConnectionFailed
Returned when an attempt to establish a secure connection fails for reasons which cannot be expressed more specifically.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorServerCertificateHasBadDate
Returned when a server certificate has a date which indicates it has expired, or is not yet valid.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorServerCertificateUntrusted
Returned when a server certificate is signed by a root server which is not trusted.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorServerCertificateHasUnknownRoot
Returned when a server certificate is not signed by any root server.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorServerCertificateNotYetValid
Returned when a server certificate is not yet valid.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorClientCertificateRejected
Returned when a server certificate is rejected.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorClientCertificateRequired
Returned when a client certificate is required to authenticate an SSL connection during an NSURLConnection request.
Available in iOS 4.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotLoadFromNetwork
Returned when a specific request to load an item only from the cache cannot be satisfied.
This error is sent at the point when the library would go to the network accept for the fact that is has been blocked from doing so by the “load only from cache” directive.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotCreateFile
Returned when NSURLDownload object was unable to create the downloaded file on disk due to a I/O failure.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotOpenFile
Returned when NSURLDownload was unable to open the downloaded file on disk.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotCloseFile
Returned when NSURLDownload was unable to close the downloaded file on disk.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotWriteToFile
Returned when NSURLDownload was unable to write to the downloaded file on disk.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotRemoveFile
Returned when NSURLDownload was unable to remove a downloaded file from disk.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorCannotMoveFile
Returned when NSURLDownload was unable to move a downloaded file on disk.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorDownloadDecodingFailedMidStream
Returned when NSURLDownload failed to decode an encoded file during the download.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
NSURLErrorDownloadDecodingFailedToComplete
Returned when NSURLDownload failed to decode an encoded file after downloading.
Available in iOS 2.0 and later.
Declared in NSURLError.h.
Availability
- Available in OS X v10.2 with Safari 1.0 installed.
- Available in OS X v10.2.7 and later.
Declared In
NSURLError.h