hw_mapid
Name
hw_mapid — Returns a local virtual object ID of a
remote document.
Synopsis
int hw_mapid(hw_link, server_id, object_id);
resource hw_link: Connection
ID to Hyperwave server
int server_id: ID of the
server on which the object resides
int object_id: Object ID of
the object to map
Returns
Object ID on success; FALSE on failure
Description
This function allows you to map the ID of a document on a
remote Hyperwave server onto a local object ID, allowing
you to access the object as though it existed on the
local server. To do so you need to know the GOid
(global object ID) of the remote object. The first part
of an object's GOid is the server's IP address
in hexadecimal; this should be passed to
hw_mapid() as server_id
; the object ID of the requested object is passed as object_id .
Note that as of PHP 4.0.5, you need to hand-modify the
source code of the file ext/hyperwave/hg_comm.c
in the PHP source tree and recompile in order to use
hw_mapid() . Instructions detailing the change are
included in comments near the top of the file.
Version
PHP 3 since 3.0.13, PHP 4 since 4.0b4
Example
Example 512. Map a remote
object to a local ID
if (($obj_id = hw_mapid($hw_link, $remote_server, $object_id)) === FALSE) {
echo "Could not map remote object; reason: " . hw_errormsg($hw_link) . ".\n";
} else {
echo "Remote object successfully mapped with object ID $obj_id.\n";
}
PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing
(Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch).
This material may be distributed only subject to the terms and conditions set forth
in the Open Publication License, v1.0 or later (the latest version is presently available at
http://www.opencontent.org/openpub/).
The authors of this book have elected not to choose any options under the OPL. This online book was obtained
from
http://www.fooassociates.com/phpfer/
and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4
for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All
persons and entities shall have neither liability nor responsibility to any person or entity with respect to
any loss or damage arising from the information contained in this book.
PhpDig.net