This function saves the image referenced by HIGEAR handle in the Internet location.
Declaration:
Copy Code | |
---|---|
AT_ERRCOUNT ACCUAPI IG_save_internet( const LPCHAR HostName, const LPCHAR URLPath, const LPCHAR UserName, const LPCHAR Password, const LONG nServerPort, DWORD dwService, DWORD dwHttpVerb, DWORD dwAccessType, const LPCHAR lpszProxyName, const LPCHAR lpszProxyBypass, DWORD dwFlags, HIGEAR hIGear, AT_LMODE lFormatType ); |
Arguments:
HostName | Set to the name of Internet host, for example "www.accusoft.com." |
URLPath | Set to the URL path to the output file, such as "/images/image1.bmp". In general, this is a path to necessary file on the given host. |
UserName | Set to the proper user name to logon. |
Password | Give the proper password to logon. |
nServerPort | Set to the number of the Internet port. Use one of the settings from parameter 3 of the Win32 function InternetConnect. |
dwService | 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. |
dwHttpVerb | Specifies the HTTP verb to use in the request. Possible values are either IG_HTTP_VERB_POST or IG_HTTP_VERB_PUT. This parameter is only used when dwService is INTERNET_SERVICE_HTTP. |
dwAccessType | Access type to be passed to the second parameter of the InternetOpen function. See description of InternetOpen function from Microsoft Win32 Internet Function Reference for details. |
lpszProxyName | Proxy name for the third parameter of InternetOpen function. See description of InternetOpen function from Microsoft Win32 Internet Function Reference for details. |
lpszProxyBypass | Bypass name for fourth parameter of InternetOpen function. See description of InternetOpen function from Microsoft Win32 Internet Function Reference for details. |
dwFlags | Flags for fifth parameter of InternetOpen function. See description of InternetOpen function from Microsoft Win32 Internet Function Reference for details. |
hIGear | Handle of the image to be saved. |
lFormatType | Specifies the format to use for saving, and also the compression scheme if applicable. See enumIGSaveFormats. |
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 Professional.
Sample:
None
Remarks:
This function does essentially the same thing as IG_save_file, except that it also lets you pass user/password, Server Port, Transfer Services information, and additional proxy information.