GetURL
PowerScript function
Description
Returns HTML for the specified URL.
Applies to
Inet objects
Syntax
|
1 |
servicereference.GetURL ( urlname, data ) |
|
Argument |
Description |
|---|---|
|
servicereference |
Reference to the Internet service |
|
urlname |
String specifying the URL whose source data is |
|
data |
InternetResult descendant containing an overridden |
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
SOFTWAREMicrosoftWindowsCurrentVersionInternet 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:
|
1 2 |
iir_msgbox = CREATE n_ir_msgbox iinet_base.GetURL(sle_url.text, iir_msgbox) |
See also