Previous Next

dced_secval_status(3dce)

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_bh
Specifies 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.

status
Returns 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
Routines: dced_secval_start(3dce)

dced_secval_stop(3dce)

dced_binding_create(3dce)

dced_binding_from_rpc_binding(3dce)

Commands: dced(8dce), secval(8dce)

Book: OSF DCE Application Development Guide - Core Components