NAME

sec_key_mgmt_initialize_cursor-Initialise cursor in local key store.

SYNOPSIS

#include <dce/keymgmt.h>

void sec_key_mgmt_initialize_cursor(
    sec_key_mgmt_authn_service authn_service,
    void *get_key_fn_arg,
    idl_char *principal_name,
    void *keytype,
    void **cursor,
    error_status_t *status);

PARAMETERS

Input

authn_service

Identifies the authentication service appropriate for this key.

get_key_fn_arg

Key acquisition routine argument (see <dce/keymgmt.h>).

principal_name

Name of the principal whose key is to be changed.

keytype

Indicates the key type (see <dce/keymgmt.h>).

Output

cursor

The returned cursor value.

status

The completion status.

DESCRIPTION

The sec_key_mgmt_initialize_cursor() routine initialises the cursor in the local key store. This prepares the cursor for a scan of the local key store via a series of calls to sec_key_mgmt_get_next_key().

The storage for the cursor information is allocated dynamically, so the returned pointer actually indicates a pointer to the cursor value. The storage for this data may be freed with the sec_key_mgmt_release_cursor() routine.

ERRORS

error_status_ok, sec_key_mgmt_e_authn_invalid, sec_key_mgmt_e_unauthorized, sec_s_no_memory.

SEE ALSO

Functions: sec_key_mgmt_get_next_key(), sec_key_mgmt_release_cursor().