sec_key_mgmt_initialize_cursor-Initialise cursor in local key store.
#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);
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.
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.
error_status_ok, sec_key_mgmt_e_authn_invalid, sec_key_mgmt_e_unauthorized, sec_s_no_memory.
Functions: sec_key_mgmt_get_next_key(), sec_key_mgmt_release_cursor().
Contents | Next section | Index |