IG_load_internet

This function loads an image from the Internet into memory and returns to you a HIGEAR handle to it.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_load_internet( const LPCHAR HostName, const LPCHAR URLPath, const LPCHAR UserName, const LPCHAR Password, const LONG nServerPort, DWORD dwService, LPHIGEAR lphIGear );

Arguments:

Name	Type	Description
HostName	const LPCHAR	Set to the name of Internet host, for example "www.accusoft.com".
URLPath	const LPCHAR	Set to the URL path to the desired file, such as "/images/image1.bmp". In general, this is a path to necessary file on the given host.
UserName	const LPCHAR	Set to the proper user name to logon.
Password	const LPCHAR	Give the proper password to logon.
nServerPort	const LONG	Set to the number of the Internet port. Use one of the settings from parameter 3 of the Win32 function InternetConnect.
dwService	DWORD	Set to one of the following values: INTERNET_SERVICE_FTP for FTP service, INTERNET_SERVICE_GOPHER for Gopher service, or INTERNET_SERVICE_HTTP for HTTP service.
lphIGear	LPHIGEAR	ImageGear returns you a HIGEAR handle to the newly loaded image.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Sample:

None

Example:

	Copy Code
AT_ERRCOUNT nErrcount; HIGEAR hIGear = 0; nErrcount = IG_load_internet("Accusoft.com", "/images/image1.bmp", "Jon", "WebMaster", 80, INTERNET_SERVICE_HTTP, &hIGear); //... // Destroy the image if(IG_image_is_valid(hIGear)) { IG_image_delete(hIGear); }

Copy Code

AT_ERRCOUNT  nErrcount;
HIGEAR hIGear = 0;
nErrcount = IG_load_internet("Accusoft.com", "/images/image1.bmp", "Jon", "WebMaster",
    80, INTERNET_SERVICE_HTTP, &hIGear);

//...

// Destroy the image
if(IG_image_is_valid(hIGear))
{
    IG_image_delete(hIGear);
}

Remarks:

This function does essentially the same thing as IG_load_file, except that it also lets you pass user/password, Server Port, and Transfer Services information.