ImageGear for C and C++ on Windows v20.0 - Updated
ART_internet_import
API Reference Guide > ART Component API Reference > ART Component Functions Reference > Internet Functions > ART_internet_import

This function can be used to load ART annotation files from FTP/GOPHER/HTTP(S).

Declaration:

 
Copy Code
AT_ERRCOUNT ART_internet_import (
        const LPCHAR HostName,
        const LPCHAR URLPath,
        const LPCHAR UserName,
        const LPCHAR Password,
        LONG nServerPort,
        DWORD dwService,
        AT_BOOL bHttpSecure, 
        DWORD dwAccessType,
        const LPSTR lpszProxyName,
        const LPSTR lpszProxyBypass,
        DWORD dwFlags,
        HIGEAR hIGear,
        HWND hWnd,
        DWORD dwGrpID, 
        DWORD dwPageNumber,
        AT_BOOL bAppend
);

Arguments:

Name Type Description
HostName const LPCHAR Set to the name of Internet host, for example "www.accusoft.com."
URLPath const LPCHAR The URL path to the annotation file, such as "/annotations/1.art". 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 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, INTERNET_SERVICE_HTTP - for HTTP service.
bHttpSecure AT_BOOL

This is a Boolean parameter that is used for HTTP service only:

  • Set this parameter to TRUE to use secure transaction semantics for HTTPS requests.
  • Set this parameter to FALSE to use non-secure transaction semantics for HTTP requests.
dwAccessType DWORD The type of access that will be passed to InternetOpen function. as second parameter. For details see description of function InternetOpen from Microsoft Win32 Internet Function Reference.
lpszProxyName const LPSTR Proxy name for the third parameter of InternetOpen function. See the description of the InternetOpen function from Microsoft's Win32 Internet Function Reference.
lpszProxyBypass const LPSTR Bypass name for fourth parameter of InternetOpen function. See the description of the InternetOpen function from Microsoft's Win32 Internet Function Reference
dwFlags DWORD Flags for fifth parameter of InternetOpen function. See the description of the InternetOpen function from Microsoft's Win32 Internet Function Reference.
hIGear HIGEAR ImageGear returns a HIGEAR handle to the newly loaded image.
hWnd HWND HWND handle to the window.
dwGrpID DWORD Identifier of the group.
dwPageNumber DWORD The number of page to load from the annotation file.
bAppend AT_BOOL Boolean flag that says whether or not to append annotations from the loaded file.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

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

Sample:

None

Remarks:

Also refer to the following functions:

Is this page helpful?
Yes No
Thanks for your feedback.