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
|