rpc_ep_register_no_replace(3rpc)Adds to server address information in the local endpoint map Used by server applications. Synopsis #include <dce/rpc.h> void rpc_ep_register_no_replace( rpc_if_handle_t if_handle, rpc_binding_vector_t *binding_vec, uuid_vector_t *object_uuid_vec, unsigned_char_t *annotation, unsigned32 *status); Parameters Input
if_handle
binding_vec
object_uuid_vec Supply the value NULL to indicate there are no object UUIDs to register.
annotation The string is used by applications for informational purposes only. The RPC runtime does not use this string to determine which server instance a client communicates with, or for enumerating endpoint map elements. Output
status
Description Each element in the local endpoint map logically contains the following: · Interface ID, consisting of an interface UUID and versions (major and minor) · Binding information · Object UUID (optional) · Annotation (optional) A server uses this routine, instead of rpc_ep_register( ), when multiple instances of the server run on the same host. Use this routine if, at any time, more than one server instance offers the same interface UUID, object UUID, and protocol sequence. Since this routine does not replace elements, calling servers must unregister (that is, remove) themselves before they stop running. Otherwise, when local endpoint map elements are not replaced, obsolete elements accumulate each time a server instance stops running without calling rpc_ep_unregister( ). Periodically the DCE Host Daemon identifies obsolete elements and removes them from the local endpoint map. However, during the time between these removals, the obsolete elements increase the chance that a client will receive endpoints to nonexistent servers. The client then wastes time trying to communicate with these servers before obtaining another endpoint. A server program calls this routine to register endpoints that were specified by calling any of the following routines: · rpc_server_use_all_protseqs( ) · rpc_server_use_protseq( ) · rpc_server_use_protseq_ep( ) A server that calls only the rpc_server_use_all_protseqs_if( ) or rpc_server_use_protseq_if( ) routine does not need to call this routine. In such cases, the client's runtime uses an endpoint from the client's interface specification to fill in a partially bound binding handle. However, it is recommended that you also register well-known endpoints that the server specifies (registering endpoints from interface definitions is unnecessary). If the server also exports to the name service database, the server calls this routine with the same if_handle, binding_vec and object_uuid_vec parameters as the server uses when calling the rpc_ns_binding_export( ) routine. The rcp_ep_register_no_replace( ) routine communicates with the DCE Host Daemon (dced), which in turn communicates with the local endpoint map. The routine communicates using one of the protocol sequences in one of the binding handles in binding_vec. The routine indicates this failure by placing the value rpc_s_comm_failure into status. For information about how the endpoint map service selects an element for an interface ID and an object UUID, see the RPC information in the OSF DCE Application Development Guide - Core Components . This guide explains how the endpoint map service searches for the endpoint of a server that is compatible with a client. If the client supplies a non-nil object UUID that is not in the endpoint map, or the client supplies a nil object UUID, the search can succeed, but only if the server has registered a nil object UUID using the rpc_ep_register_no_replace( ) or rpc_ep_register( ) routine. The object_uuid_vec parameter can contain both nil and non-nil object UUIDs for the routine to place into endpoint map elements. For an explanation of how a server can establish a client/server relationship without using the local endpoint map, see the explanation of a string binding in rpc_intro(3rpc) . This routine creates a cross-product from the if_handle, binding_vec and object_uuid_vec parameters, and adds each element in the cross-product as a separate registration in the local endpoint map. If you supply NULL to object_uuid_vec, the corresponding elements in the cross-product contain a nil object UUID. The rpc_ep_register( ) routine's reference page summarizes the contents of an element in the local endpoint map.
Return Values Errors The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.
rpc_s_ok
ept_s_cant_access
ept_s_cant_create
ept_s_cant_perform_op
ept_s_database_invalid
ept_s_invalid_entry
ept_s_update_failed
rpc_s_comm_failure
rpc_s_invalid_binding
rpc_s_no_bindings
rpc_s_wrong_kind_of_binding
Related Information rpc_server_use_all_protseqs(3rpc) rpc_server_use_all_protseqs_if(3rpc) rpc_server_use_protseq_ep(3rpc) rpc_server_use_protseq_if(3rpc) Books: OSF DCE Application Development Guide - Core Components
|