NAME

dce_server_sec_begin - Establishes a server to receive fully authenticated remote procedure calls (RPCs) and to also act as a client to do authenticated RPCs

SYNOPSIS

#include <dce/dced.h>
void                                        dce_server_sec_begin(
        unsigned32              flags,
        error_status_t          *status);

PARAMETERS

Input

flags

Flags are set to manage keys and setup a login context. Valid values include the following:

dce_server_c_manage_key dce_server_c_login

Output

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                       dced_s_need_one_server_prin
dced_s_not_started_by_dced               dced_s_no_server_keyfile
dced_s_cannot_create_key_mgmt_thr
dced_s_cannot_detach_key_mgmt_thr

DESCRIPTION

The dce_server_sec_begin() routine prepares a server to receive authenticated RPCs. It also sets up all that is required for the application, when behaving as a client to other servers, to do authenticated RPCs as a client. When authentication is required, this call must preceed all other RPC and DCE server initialization calls, including dce_server_register(). When your application is finished listening for RPCs, it should call the dce_server_sec_done() routine.

RELATED INFORMATION

Routines:   dce_server_register(3dce),    rpc_server_listen(3rpc),
            dce_server_sec_done(3dce).

Books: OSF DCE Application Development Guide.