VMS Help DCE_SECURITY, API Routines, sec_cred_is_authenticated  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   sec_cred_is_authenticated - Returns true if the supplied credentials
                               are authenticated and false if they are not

 SYNOPSIS

   #include <dce/sec_cred.h>

   boolean32 sec_cred_is_authenticated(
           rpc_authz_cred_handle_t callers_identity,
           error_status_t *status);

 PARAMETERS

   Input

   callers_identity
          A handle of type rpc_authz_cred_handle_t to the credentials to
          check for authentication. This handle is supplied as output of
          the rpc_binding_inq_auth_caller() call.

   Output

   status
          A pointer to the completion status.  On successful completion,
          status is assigned error_status_ok.  Otherwise, it returns an
          error.

 DESCRIPTION

   The sec_cred_is_authenticated() routine returns true if the credentials
   identified by callers_identity are authenticated or false if they are
   not.

   Before you execute this call, you must execute an
   rpc_binding_inq_auth_caller() call to obtain an rpc_authz_cred_handle_t
   for the callers_identity parameter.

 FILES
     SYS$COMMON:[DCE$LIBRARY]SEC_CRED.IDL
                The idl file from which dce/sec_cred.h was derived.

 RETURN VALUES

   The routine returns true is the credentials are authenticated; false if
   they are not.

 ERRORS

   TBS

 RELATED INFORMATION

   Functions: sec_intro
              rpc_binding_inq_auth_caller