Previous section.

CDE 1.1: Remote Procedure Call
Copyright © 1997 The Open Group

NAME

rpc_server_unregister_if- removes an interface from the RPC run-time system

SYNOPSIS

#include <dce/rpc.h>

void rpc_server_unregister_if( rpc_if_handle_t if_handle, uuid_t *mgr_type_uuid, unsigned32 *status);

PARAMETERS

Input

if_handle
Specifies an interface specification to unregister (that is, remove).

The application specifies NULL to remove all interfaces previously registered with the type UUID value given in the mgr_type_uuid argument.

mgr_type_uuid
Specifies the type UUID for the manager entry point vector (EPV) to remove.
Note:
This should be the same value as was provided in a call to the rpc_server_register_if() routine.

The application specifies NULL to remove the interface given in the if_handle argument for all previously registered type UUIDs.

The application specifies a nil UUID to remove the default manager EPV. In this case all manager EPVs registered with a non-nil type UUID remain registered.

Output

status
Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok
Success.

rpc_s_unknown_if

Unknown interface.

rpc_s_unknown_mgr_type

Unknown manager type.

DESCRIPTION

The rpc_server_unregister_if() routine removes the association between an interface and a manager entry point vector (EPV).

The application specifies the manager EPV to remove by providing in the mgr_type_uuid argument the type UUID value specified in a call to the rpc_server_register_if() routine. Once removed, an interface is no longer available to client applications.

When an interface is removed, the RPC run-time system stops accepting new calls for that interface.

The following table summarises the behaviour of this routine.

if_handle mgr_type_uuid Behaviour
non-NULL non-NULL Removes the manager EPV associated with the specified arguments.
non-NULL NULL Removes all manager EPVs associated with argument if_handle.
NULL non-NULL Removes all manager EPVs associated with argument mgr_type_uuid.
NULL NULL Removes all manager EPVs.

Note:
When both of the arguments if_handle and mgr_type_uuid are given the value NULL, this call has the effect of preventing the server from receiving any new remote procedure calls since all the manager EPVs for all interfaces have been removed.

RETURN VALUE

None.

SEE ALSO


rpc_server_register_if().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index