Creates a Remote Procedure Call (RPC) handle.
handle_t rpc_$alloc_handle
( object_id, family, status)
uuid_$t *object_id; unsigned long family; status_$t *status;
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.
status | Points to the completion status. |
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.
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);
Remote Procedure Call (RPC) Runtime Library (NCS) in AIX 5L Version 5.2 Communications Programming Concepts.