[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 1


rpc_$clear_binding Library Routine

Purpose

Unsets the binding between a Remote Procedure Call (RPC) handle and a host and server.

Syntax


void rpc_$clear_binding ( handle, status)
handle_t handle;
status_$t *status;

Description

The rpc_$clear_binding routine removes any association between an RPC handle and a particular server and host, but does not remove the association between the handle and an object. This routine saves the RPC handle so that it can be reused to access the same object, either by broadcasting or after resetting the binding to another server.

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.

The rpc_$clear_binding routine reverses an rpc_$set_binding routine.

Parameters

Input


handle Specifies the RPC handle from which the binding is being cleared.

Output


status Points to the completion status.

Note: This routine is used by clients only.

Examples

To clear the binding represented in a handle, enter:

rpc_$clear_binding(handle, &st);

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.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]