NAME

sec_key_mgmt_get_next_key-Retrieve key indicated by cursor 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

The current retrieval position in the local key storage.

Output

principal_name

Name of the principal associated with the retrieved key.

key_vno

The version number of the extracted key.

keydata

The retrieved key data (see <dce/keymgmt.h>).

status

The completion status.

DESCRIPTION

The sec_key_mgmt_get_next_key() routine retrieves the key indicated by the cursor in the local key store, and updates the cursor to point to the next key. The entire local key store can be scanned by a series of calls to this routine.

ERRORS

error_status_ok, sec_key_mgmt_e_key_unavailable, sec_key_mgmt_e_unauthorized, sec_s_no_memory.

SEE ALSO

Functions: sec_key_mgmt_get_key(), sec_key_mgmt_initialize_cursor().