Name

dced_secval_status - Indicates whether or not a specific host’s security validation service of dced is running

Synopsis

#include <dce/dced.h> void dced_secval_status(
dced_binding_handle_t dced_bh,
boolean32 ∗secval_active,
error_status_t ∗status);

Parameters

Input

dced_bhSpecifies the dced binding handle for the secval service on a specific host. 

Output

secval_active
Returns a value of TRUE if the security validation service is running and FALSE if it is not running.

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

The dced_secval_status() routine sets a parameter to TRUE or FALSE depending on whether the security validation service has been activated or deactivated. 

Prior to calling this routine, the application must have established a valid dced binding handle to the secval service by calling either the dced_binding_create() or dced_binding_from_rpc_binding() routine. 

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. 

error_status_ok

dced_s_bad_binding

Related Information

Commands: dced(8dce), the secval(8dce) object of dcecp. 

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_secval_start(3dce), dced_secval_stop(3dce). 

Books: OSF DCE Application Development Guide.