Technical Reference: Communications, Volume 1

rpc_$bind Library Routine

Purpose

Allocates an Remote Procedure Call (RPC) handle and sets its binding to a server.

Syntax

handle_t rpc_$bind ( object_id, sockaddr, slength, status)

uuid_$t *object_id;
socket_$addr_t *sockaddr;
unsigned long slength;
us_$t *status;

The rpc_$bind function creates a fully bound RPC handle that identifies a particular object and server. This routine is equivalent to an rpc_$alloc_handle routine followed by an rpc_$set_binding routine.

Note: This routine is used by clients only.

Parameters

Input

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.
sockaddr	Points to the socket address of the server.
slength	Specifies the length, in bytes, of the socket address (sockaddr) parameter.

Output

status

Points to the completion status.

Return Values

Upon successful completion, this routine returns an RPC handle (handle_t) that identifies the remote object. This handle is used as the first input parameter to remote procedure calls with explicit handles.

Examples

The following example binds a banking client program to the specified object and socket address:

h =rpc_$bind(&bank_id, &bank_loc[0].saddr, bank_loc[0].saddr_len,
    &st);

The bank_loc structure is the results parameter of a previous Location Broker lookup call.

Implementation Specifics

This Library Routine is part of Network Computing System in Network Support Facilities in Base Operating System (BOS) Runtime.

Related Information

Remote Procedure Call (RPC) Runtime Library (NCS) in AIX 5L Version 5.1 Communications Programming Concepts.