Creates a Remote Procedure Call (RPC) handle.
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.
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. |
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);