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

 NAME

   sec_cred_get_pa_data - Returns identity information from a privilege
                          attribute handle

 SYNOPSIS

   #include <dce/sec_cred.h>

   sec_id_pa_t *sec_cred_get_pa_data(
           sec_cred_pa_handle_t callers_pas,
           error_status_t *status);

 PARAMETERS

   Input

   callers_pas
       A handle of type sec_cred_pa_handle_t to a principal's privilege
       attributes. This handle is supplied as output of either the
       sec_cred_get_initiator() call or sec_cred_get_delegate() call.

   Output

   status
       A pointer to the completion status.  On successful completion,
       status is assigned error_status_ok.

 DESCRIPTION

   The sec_cred_get_pa_data() routine extracts identity information from
   the privilege attribute handle specified by callers_pas and returns it
   in a sec_id_pa_t.  The identity information includes an identifier of
   the princpal's locall cell and the principal's local and foreign group
   sets.

   Before you execute sec_cred_get_pa_data(), you must execute a
   sec_cred_get_initiator() or sec_cred_get_delegate() call to obtain a
   sec_cred_pa_handle_t for the callers_pas parameter.

 ERRORS

   sec_cred_s_invalid_pa_handle

   error_status_ok

 RELATED INFORMATION

   Functions: sec_intro
              sec_cred_get_delegate
              sec_cred_get_initiator