<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Gets a remote document</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.hw-getrellink.html">hw_getrellink</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.hw-getremotechildren.html">hw_getremotechildren</a></div>
<div class="up"><a href="ref.hw.html">Hyperwave Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.hw-getremote" class="refentry">
<div class="refnamediv">
<h1 class="refname">hw_GetRemote</h1>
<p class="verinfo">(PHP 4)</p><p class="refpurpose"><span class="refname">hw_GetRemote</span> — <span class="dc-title">Gets a remote document</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.hw-getremote-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">int</span> <span class="methodname"><strong>hw_getremote</strong></span>
( <span class="methodparam"><span class="type">int</span> <code class="parameter">$connection</code></span>
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$objectID</code></span>
)</div>
<p class="para rdfs-comment">
Gets a remote document.
</p>
<p class="para">
Remote documents in Hyperwave notation are documents retrieved from an
external source. Common remote documents are for example external web
pages or queries in a database.
</p>
<p class="para">
In order to be able to access external sources through remote documents
Hyperwave introduces the HGI (Hyperwave Gateway Interface) which is
similar to the CGI. Currently, only ftp, http-servers and some databases
can be accessed by the HGI.
</p>
<p class="para">
Calling <span class="function"><strong>hw_getremote()</strong></span> returns the document from
the external source. If you want to use this function you should be
very familiar with HGIs. You should also consider to use PHP instead
of Hyperwave to access external sources. Adding database support
by a Hyperwave gateway should be more difficult than doing it in PHP.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.hw-getremote-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">connection</code></em></span>
<dd>
<p class="para">
The connection identifier.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">objectID</code></em></span>
<dd>
<p class="para">
The object identifier.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.hw-getremote-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns a remote document.
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.hw-getremote-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.hw-getremotechildren.html" class="function" rel="rdfs-seeAlso">hw_getremotechildren()</a> - Gets children of remote document</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.hw-getrellink.html">hw_getrellink</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.hw-getremotechildren.html">hw_getremotechildren</a></div>
<div class="up"><a href="ref.hw.html">Hyperwave Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
