Name

dce_svc_components − 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

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

statusReturns 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 insufficient,  ∗/
  /∗ deny the request. Otherwise, proceed with operation   ∗/
 dce_svc_components(table, st);
}

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.  See dce_svc_register(3dce). 

Files

dce/service.idl