VMS Help DCE, dce_intro, dce_server_intro, dce_server_sec_begin  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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 authenti-
                          cated 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
               rpc_server_listen
               dce_server_sec_done

   Books: OSF DCE Application Development Guide