PreviousNext

dce_server_sec_begin(3dce)

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.

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
Routines: dce_server_register(3dce)

rpc_server_listen(3rpc)

dce_server_sec_done(3dce)

Book: OSF DCE Application Development Guide - Core Components