NAME

rpc_mgmt_ep_unregister- removes server address information from an endpoint map

SYNOPSIS

#include <dce/rpc.h>

void rpc_mgmt_ep_unregister(
	rpc_binding_handle_t ep_binding,
	rpc_if_id_t *if_id,
	rpc_binding_handle_t binding,
	uuid_t *object_uuid,
	unsigned32 *status);

PARAMETERS

Input

ep_binding

Specifies the host whose endpoint map elements are to be unregistered. To remove elements from the same host as the calling application, the application specifies NULL.

To remove endpoint map elements from another host, the application specifies a server binding handle for any server residing on that host.

Note:

The application can specify the same binding handle it is using to make other remote procedure calls.

if_id

Specifies the interface identifier to remove from the endpoint map.

binding

Specifies the binding handle to remove.

object_uuid

Specifies an optional object UUID to remove.

The value NULL indicates there is no object UUID to remove.

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.

ept_s_cant_perform_op

Cannot perform the requested operation.

rpc_s_comm_failure

Communications failure.

ept_s_not_registered

No entries found.

DESCRIPTION

The rpc_mgmt_ep_unregister() routine unregisters an element from an endpoint map. A management program calls this routine to remove addresses of servers that are no longer available, or to remove addresses of servers that support objects that are no longer offered.

The ep_binding argument must be a full binding. The object UUID associated with the ep_binding argument must be a nil UUID. Specifying a non-nil UUID causes the routine to fail with the status code ept_s_cant_perform_op. Other than the host information and object UUID, all information in this argument is ignored.

Note:

Use this routine cautiously. Removing elements from the local endpoint map may make servers unavailable to client applications that do not already have a fully bound binding handle to the server.

An application calls the rpc_mgmt_ep_elt_inq_next() routine to view local endpoint map elements. The application can then remove the elements using the rpc_mgmt_ep_unregister() routine.

RETURN VALUE

None.

SEE ALSO

rpc_ep_register()
rpc_ep_register_no_replace()
rpc_ns_binding_unexport()
rpc_mgmt_ep_elt_inq_begin()
rpc_mgmt_ep_elt_inq_done()
rpc_mgmt_ep_elt_inq_next().

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.