sec_key_mgmt_get_next_key(3sec)
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
/usr/lib/dce/keymgmt.idl
The idl file from which dce/keymgmt.h was derived.
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.
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_key_mgmt_initialize_cursor(3sec)