PreviousNext

Registering Endpoints

Servers can use well-known or dynamic endpoints with any protocol sequence.

When a server asks the runtime to use a dynamic endpoint with a protocol sequence, the runtime asks the operating system to generate the endpoint. To use the dynamic endpoints, a server must register the server's binding information, including the endpoints, by using the rpc_ep_register( ) routine. For each combination of RPC interface identifier, object UUID, and binding information that the server offers, the endpoint mapper service creates an element in the local endpoint map.

A server does not necessarily need to register well-known endpoints; however, by registering well-known endpoints, the server ensures that clients can always obtain them. Registration also makes the endpoints accessible to administrators, who can use the DCE control program, dcecp, to show the map elements of an endpoint map by using the endpoint show operation.

Servers can remove map elements from a local endpoint map by using the rpc_ep_unregister( ) routine. Servers should unregister endpoints after they stop listening.