rpc_$alloc_handle Library Routine

Purpose

Creates a Remote Procedure Call (RPC) handle.

Syntax

handle_t rpc_$alloc_handle
( object_id,  family,  status)

uuid_$t *object_id;
unsigned long family;
status_$t *status;

Description

The rpc_$alloc_handle routine creates an unbound RPC handle that identifies a particular object but not a particular server or host. A remote procedure call made using an unbound handle is broadcast to all Local Location Brokers (LLBs) on the local network. If the call's interface and the object identified by the handle are both registered with any LLB, that LLB forwards the request to the registering server. The client RPC runtime library returns the first response that it receives and binds the handle to the server.

Note: This routine is used by clients only.

Parameters

Input

Item Description
object_id Points to the Universal Unique Identifier (UUID) of the object to be accessed. If there is no specific object, specify uuid_$nil as the value.
family Specifies the address family to use in communications to access the object.

Output

Item Description
status Points to the completion status.

Return Values

Upon successful completion, the rpc_$alloc_handle routine returns an RPC handle identifying the remote object in the form handle_t. This handle is used as the first input parameter to remote procedure calls with explicit handles.

Examples

The following statement allocates a handle that identifies the Acme company's payroll database object:

handle = rpc_$alloc_handle (&acme_pay_id, socket_$dds, &st);