IResourceHandler Methods

Request processing has been canceled.

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Retrieve response header information. If the response length is not known set responseLength to -1 and ReadResponse() will be called until it returns false. If the response length is known set responseLength to a positive value and ReadResponse() will be called until it returns false or the specified number of bytes have been read. It is also possible to set response to a redirect http status code and pass the new URL via a Location header. Likewise with redirectUrl it is valid to set a relative or fully qualified URL as the Location header value. If an error occured while setting up the request you can call ErrorCode on response to indicate the error condition.

Open the response stream. - To handle the request immediately set handleRequest to true and return true. - To decide at a later time set handleRequest to false, return true, and execute callback to continue or cancel the request. - To cancel the request immediately set handleRequest to true and return false. This method will be called in sequence but not from a dedicated thread. For backwards compatibility set handleRequest to false and return false and the ProcessRequest(IRequest, ICallback) method will be called.

Begin processing the request.

Read response data. If data is available immediately copy up to dataOut.Length bytes into dataOut, set bytesRead to the number of bytes copied, and return true. To read the data at a later time keep a pointer to dataOut, set bytesRead to 0, return true and execute callback when the data is available (dataOut will remain valid until the callback is executed). To indicate response completion set bytesRead to 0 and return false. To indicate failure set bytesRead to < 0 (e.g. -2 for ERR_FAILED) and return false. This method will be called in sequence but not from a dedicated thread. For backwards compatibility set bytesRead to -1 and return false and the ReadResponse method will be called.

Read response data. If data is available immediately copy to dataOut, set bytesRead to the number of bytes copied, and return true. To read the data at a later time set bytesRead to 0, return true and call ICallback.Continue() when the data is available. To indicate response completion return false.

Skip response data when requested by a Range header. Skip over and discard bytesToSkip bytes of response data. - If data is available immediately set bytesSkipped to the number of of bytes skipped and return true. - To read the data at a later time set bytesSkipped to 0, return true and execute callback when the data is available. - To indicate failure set bytesSkipped to < 0 (e.g. -2 for ERR_FAILED) and return false. This method will be called in sequence but not from a dedicated thread.