Readonly schemeOptional aInstancePtr: objectA run time mechanism for interface discovery.
NS_OK if the interface is supported by the associated instance, NS_NOINTERFACE if it is not.
aInstancePtr must not be null.
[in] A requested interface IID
[out] A pointer to an interface pointer to receive the result.
Allows a protocol to override blacklisted ports.
This method will be called when there is an attempt to connect to a port that is blacklisted. For example, for most protocols, port 25 (Simple Mail Transfer) is banned. When a URI containing this "known-to-do-bad-things" port number is encountered, this function will be called to ask if the protocol handler wants to override the ban.
Converts a non-directory nsIFile to the corresponding URL string. NOTE: under some platforms this is a lossy conversion (e.g., Mac Carbon build). If the nsIFile is a local file, then the result will be a file:// URL string.
The resulting string may contain URL-escaped characters.
Should only be called on files which are not directories. If called on directories, the resulting URL may lack a trailing slash and cause relative URLs in such a document to misbehave.
Converts a directory nsIFile to the corresponding URL string. NOTE: under some platforms this is a lossy conversion (e.g., Mac Carbon build). If the nsIFile is a local file, then the result will be a file:// URL string.
The resulting string may contain URL-escaped characters.
Should only be called on files which are directories (will enforce the URL ends with a slash).
DEPRECATED, AVOID IF AT ALL POSSIBLE.
Calling this will cause IO on the calling thread, to determine if the file is a directory or file, and based on that behaves as if you called getURLSpecFromDir or getURLSpecFromActualFile, respectively. This IO may take multiple seconds (e.g. for network paths, slow external drives that need to be woken up, etc.).
Usually, the caller should know that the file argument is
either a directory (in which case it should call getURLSpecFromDir)
or a non-directory file (in which case it should call
getURLSpecFromActualFile), and not need to call this method.
Takes a local file and tries to interpret it as a shell link file (.lnk files on Windows)
The URI the file refers to
NS_ERROR_NOT_AVAILABLE if the OS does not support such files.
NS_ERROR_NOT_AVAILABLE if this file is not a shell link.
The local file to read
Takes a local file and tries to interpret it as an internet shortcut (e.g. .url files on windows).
The URI the file refers to
NS_ERROR_NOT_AVAILABLE if the OS does not support such files.
NS_ERROR_NOT_AVAILABLE if this file is not an internet shortcut.
The local file to read
Generated using TypeDoc
The scheme of this protocol (e.g., "file").