EXPORT_SPEC int UpnpOpenHttpGetEx

( IN const char* url,
  IN OUT void** handle,
  IN OUT char** contentType,
  IN OUT int* contentLength,
  IN OUT int* httpStatus,
  IN int lowRange,
  IN int highRange,
  IN int timeout )

UpnpOpenHttpGetEx gets specified number of bytes from a file specified in the URL.

Documentation

UpnpOpenHttpGetEx gets specified number of bytes from a file specified in the URL. The number of bytes is specified through a low count and a high count which are passed as a range of bytes for the request. The SDK allocates the memory for handle and contentType, the application is responsible for freeing this memory.

Parameters:

url - The URL of the item to get.
handle - A pointer to store the handle for this connection.
contentType - A buffer to store the media type of the item.
contentLength - A buffer to store the length of the item.
httpStatus - The status returned on receiving a response message from the remote server.
lowRange - An integer value representing the low end of a range to retrieve.
highRange - An integer value representing the high end of a range to retrieve.
timeout - A time out value sent with the request during which a response is expected from the server, failing which, an error is reported back to the user.

Returns:

[int] An integer representing one of the following:

• UPNP_E_SUCCESS: The operation completed successfully.
• UPNP_E_INVALID_PARAM: Either url, handle, contentType, contentLength or httpStatus is not a valid pointer.
• UPNP_E_INVALID_URL: The url is not a valid URL.
• UPNP_E_OUTOF_MEMORY: Insufficient resources exist to download this file.
• UPNP_E_NETWORK_ERROR: A network error occurred.
• UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
• UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
• UPNP_E_SOCKET_BIND: An error occurred binding a socket.
• UPNP_E_SOCKET_CONNECT: An error occurred connecting a socket.
• UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.
• UPNP_E_BAD_RESPONSE: A bad response was received from the remote server.

Alphabetic index