Description
Returns HTML for the specified URL.
Applies to
Inet objects
Syntax
servicereference.GetURL ( urlname, data )
|
Argument |
Description |
|---|---|
|
servicereference |
Reference to the Internet service instance |
|
urlname |
String specifying the URL whose source data is returned in data |
|
data |
InternetResult descendant containing an overridden InternetData function that handles the HTML source for urlname |
Return value
Integer.
Returns values as follows:
1 -- Success
-1 -- General error
-2 -- Invalid URL
-4 -- Cannot connect to the Internet
Usage
Call this function to access HTML source for a URL.
Data references a standard class user object that descends from InternetResult and that has an overridden InternetData function. This overridden function then performs the processing you want with the returned HTML. Because the Internet returns data asynchronously, data must reference a variable that remains in scope after the function executes (such as a window-level instance variable).
For more information on the InternetResult standard class user object and the InternetData function, use the PowerBuilder Browser.
Timeout value for retrieving HTML source
The GetURL function relies on wininet.dll to obtain the HTML source and returns -1 when the retrieval time exceeds the DLL timeout value. When you install Internet Explorer 7 or later, the default timeout value for this DLL is 30 seconds. Although it is possible to change the timeout value by configuring a DWORD ReceiveTimeOut registry key under HKEY_CURRENT_USER\ SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings, this is not recommended, since it can also affect the behavior of the Internet Explorer browser.
Examples
This example calls the GetURL function. Iinet_base is an instance variable of type inet:
iir_msgbox = CREATE n_ir_msgbox iinet_base.GetURL(sle_url.text, iir_msgbox)
See also
