<!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 children of 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-getremote.html">hw_GetRemote</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.hw-getsrcbydestobj.html">hw_GetSrcByDestObj</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-getremotechildren" class="refentry">
<div class="refnamediv">
<h1 class="refname">hw_getremotechildren</h1>
<p class="verinfo">(PHP 4)</p><p class="refpurpose"><span class="refname">hw_getremotechildren</span> — <span class="dc-title">Gets children of remote document</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.hw-getremotechildren-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <span class="methodname"><strong>hw_getremotechildren</strong></span>
( <span class="methodparam"><span class="type">int</span> <code class="parameter">$connection</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$object_record</code></span>
)</div>
<p class="para rdfs-comment">
Returns the children of a remote document. Children of a remote document
are remote documents itself. This makes sense if a database query has to
be narrowed and is explained in Hyperwave Programmers' Guide.
</p>
<p class="para">
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-getremotechildren-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">object_record</code></em></span>
<dd>
<p class="para">
The object record.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.hw-getremotechildren-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
If the number of children is 1 the function will return the document
itself formatted by the Hyperwave Gateway Interface (HGI). If the number
of children is greater than 1 it will return an array of object record
with each maybe the input value for another call to
<span class="function"><strong>hw_getremotechildren()</strong></span>. Those object records are
virtual and do not exist in the Hyperwave server, therefore they do not
have a valid object ID. How exactly such an object record looks like is up
to the HGI.
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.hw-getremotechildren-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.hw-getremote.html" class="function" rel="rdfs-seeAlso">hw_getremote()</a> - Gets a 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-getremote.html">hw_GetRemote</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.hw-getsrcbydestobj.html">hw_GetSrcByDestObj</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>
