rpc_$unregister Library Routine

Communications Technical Reference, Volume 1

rpc_$unregister Library Routine

Purpose

Unregisters an interface.

Syntax

void rpc_$unregister (if_spec, status)
rpc_$if_spec_t *if_spec;
status_$t *status;

Description

The rpc_$unregister routine unregisters an interface that the server previously registered with the Remote Procedure Call (RPC) runtime library. After an interface is unregistered, the RPC runtime library does not pass requests for that interface to the server.

If a server uses multiple calls to the rpc_$register routine to register an interface more than once, then the server must call the rpc_$unregister routine an equal number of times to unregister the interface.

Parameters

Input
if_spec	Points to the interface being unregistered.

Output
status	Points to the completion status.

Note: This routine is used by servers only.

Examples

To unregister a matrix arithmetic interface, use the following:

rpc_$unregister (&matrix_$if_spec, &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 Version 4.3 Communications Programming Concepts.