Creates a Remote Procedure Call (RPC) 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.
Note: This routine is used by clients only.
|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.|
|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);
This Library Routine is part of Network Computing System in Network Support Facilities in Base Operating System (BOS) Runtime.
Remote Procedure Call (RPC) Runtime Library (NCS) in AIX 5L Version 5.1 Communications Programming Concepts.