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

 NAME
   dce_svc_components - DCE serviceability routine that returns
                        registered component names

 SYNOPSIS

   #include <dce/dce.h>
   #include <dce/svcremote.h>

   void dce_svc_components( dce_svc_stringarray_t *table,
                            error_status_t *status );

 PARAMETERS

   Output

   table  An array containing the names of all components that have been
          registered with the dce_svc_register() routine.

   status
          Returns the status code from this operation. The status code
          is a value that indicates whether the routine completed
          successfully and if not, why not.

 DESCRIPTION

   The dce_svc_components routine returns an array containing the names
   of all components in the program that have been registered with the
   dce_svc_register() routine.

 EXAMPLES

   The following code fragment shows how the dce_svc_components()
   routine should be used in a DCE application's implementation of the
   serviceability remote interface. The function defined below is the
   implementation of the app_svc_inq_components operation defined in the
   application's serviceability .epv file. Clients call this function
   remotely, and the function, when called, first checks the caller's
   authorization and then (if the client is authorized to perform the
   operation) calls the dce_svc_components() routine to perform the
   actual operation.

        /*****
        *
        * app_svc_inq_components -- remote request for list of all
        *                           components registered by
        *                           dce_svc_register().
        *
        *****/
        static void
        app_svc_inq_components( handle_t                h,
                                dce_svc_stringarray_t   *table,
                                error_status_t          *st )
        {
                int  ret;

    /* Check the client's permissions here; if they are insufficient, */
    /*  deny the request. Otherwise, proceed with the operation...    */

                dce_svc_components(table, st);
        }

 ERROR CODES

   See dce_svc_register.

 FILES

   dce/service.idl