ART_internet

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 );

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: