Name

dce_server_sec_begin - Establishes a server to receive fully authenticated RPCs and to 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

flagsFlags 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

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

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 precede 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. 

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. 

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

Related Information

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

Books: OSF DCE Application Development Guide.