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

 NAME
   sec_key_mgmt_get_next_key - Retrieves successive keys from the local
                               key storage

 SYNOPSIS

   #include <dce/keymgmt.h>

   void sec_key_mgmt_get_next_key(
           void *cursor,
           idl_char **principal_name,
           unsigned32 *key_vno,
           void **keydata,
           error_status_t *status);

 PARAMETERS

   Input

   cursor
          A pointer to the current cursor position in the local key
          storage.  The cursor position is set via the routine
          sec_key_mgmt_initialize_cursor().

   Output

   principal_name
          A pointer to a character string indicating the name of the
          principal associated with the extracted key.  Free the storage
          for the principal name with the free() function.

   key_vno
          The version number of the extracted key.

   keydata
          A pointer to a value of type sec_passwd_rec_t. The storage for
          keydata is allocated dynamically, so the returned pointer
          actually indicates a pointer to the key value.  The storage for
          this data may be freed with the sec_key_mgmt_free_key() function.

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

 DESCRIPTION

   The sec_key_mgmt_get_next_key() routine extracts the key pointed to by
   the cursor in the local key store and updates the cursor to point to the
   next key.  By repeatedly calling this routine you can scan all the keys
   in the local store.

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

 ERRORS

   sec_key_mgmt_e_key_unavailable
                The requested key is not present.

   sec_key_mgmt_e_unauthorized
                The caller is not authorized to perform the operation.

   sec_s_no_memory
                Unable to allocate memory.

   error_status_ok
                The call was successful.

 RELATED INFORMATION

   Functions: sec_intro
              sec_key_mgmt_get_key
              sec_key_mgmt_initialize_cursor