NAME

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.

ERROR CODES

See: dce_svc_register(3dce)
.

FILES

dce/service.idl