dce_svc_filter(3dce)
Controls behavior of serviceability filter
Synopsis
#include <dce/dce.h>
#include <dce/svcremote.h>
void dce_svc_filter(
dce_svc_string_t component,
idl_long_int arg_size,
idl_byte *argument,
error_status_t *status);
Parameters
Input
component
The name of the serviceability-registered component, defined in the component field of the sams file.
arg_size
The number of characters contained in argument.
argument
A string value to be interpreted by the target component's filter control routine.
Output
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_filter( ) routine controls the behavior of the serviceability message filtering routine, if one exists.
Along with the filter routine itself, the application also installs a filter control routine, whose purpose is to permit the behavior of the filter to be altered dynamically while the application is running. The dce_svc_filter( ) routine is the interface's call-in to such an installed filter control.
If an application has installed a serviceability filtering routine, and if filter remote control is desired, the application's filter routine (installed by the call to dce_svc_define_filter( )) should be coded so that its operation can be switched to the various desired alternatives by the values of static variables to which it has access. These variables should also be accessible to the filter control routine. The filter control routine thus receives from dce_svc_filter( ) an argument string (which it uses to set the variables), the meaning of whose contents are entirely application-defined.
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.
Files
dce/service.idl