NAME

dce_server_register - Registers a server with DCE

SYNOPSIS

#include <dce/dced.h>
void                                         dce_server_register(
        unsigned32              flags,
        server_t                *server,
        dce_server_register_data_t      *data,
        dce_server_handle_t     *server_handle,
        error_status_t          *status);

PARAMETERS

Input

flags

Specifies options for server registration. Combinations of the following values may be used:

dce_server_c_no_protseqs                dce_server_c_no_endpoints
dce_server_c_ns_export

server

Specifies the server data, commonly obtained from dced by calling dce_server_inq_server(). The server_t structure is described in sec_intro(3sec).

data

Specifies the array of data structures that contain the additional information required for the server to service requests for specific remote procedures. Each structure of the array includes:

An interface handle (ifhandle) of type rpc_if_handle_t

An entry point vector (epv) of type rpc_mgr_epv_t

A number (num_types) of type unsigned32 representing the number in the following array

An array of server types (types) of type dce_server_type_t

The dce_server_type_t structure contains a UUID (type) of type uuid_t representing the object type, and a manager entry point vector (epv) of type rpc_mgr_epv_t representing the set of procedures implemented for the object type.

Output

server_handle Returns a server handle, which is a pointer to an opaque data structure containing information about the server.

status

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

error_status_ok rpc_s_no_memory

DESCRIPTION

By default, the dce_server_register() routine registers a DCE server by establishing a server's binding information for all valid protocol sequences, registering all the servers services with the RPC runtime, and entering the server's endpoints in dced's endpoint mapper service.

Prior to calling the dce_server_register() routine, the server obtains the server configuration data from dced by calling dce_server_inq_server(). The server must also set up an array of registration data, where the size of the array represents all the server's services that are currently registered in the server configuration data of dced. (server->services.count). If the memory for the array is dynamically allocated, it must not be freed until after the corresponding dce_server_unregister() routine is called.

You can modify the behavior of dce_server_register() Depending on the values of the flags parameter. If the flag has the value dce_server_c_ns_export, the the binding information is also exported to the namespace. The namespace entry is determined for each service by the server->services.list[i].entryname parameter. If this parameter has no value, the default value for the entire server is used (server->entryname). If the flag has the value dce_server_c_no_endpoints, the binding information is not registered with the endpoint map. Your application can use rpc_ep_register() to register specific binding information. If the flag has the value dce_server_c_no_protseqs, specific protocol sequences are used rather than all valid protocol sequences. Use of this flag requires that the server first call dce_server_use_protseq() at least once for a valid protocol sequence.

RELATED INFORMATION

Routines:   dced_intro(3dce),              dce_server_inq_server(3dce),
            dce_server_unregister(3dce),   rpc_server_listen(3rpc),
            dce_server_sec_begin(3dce).

Books: OSF DCE Application Development Guide.