sec_key_mgmt_garbage_collect-Delete unusable keys from local key store.
#include <dce/keymgmt.h>
void sec_key_mgmt_garbage_collect(
sec_key_mgmt_authn_service authn_service,
void *get_key_fn_arg,
idl_char *principal_name,
error_status_t *status);
Input
- authn_service
Identifies the authentication service appropriate for the keys to be garbage-collected.
- get_key_fn_arg
Key acquisition routine argument (see<dce/keymgmt.h> ).
- principal_name
Name of the principal whose keys are to be garbage collected.
Output
- status
The completion status.
The sec_key_mgmt_garbage_collect() routine discards unusable keys (that is, keys for which there can be no outstanding ticket protected with that key) for the specified principal from local key store.
error_status_ok, sec_login_s_no_memory, sec_key_mgmt_e_authn_invalid, sec_key_mgmt_e_unauthorized, sec_key_mgmt_e_key_unavailable, sec_rgy_object_not_found, sec_rgy_server_unavailable.
Functions: sec_key_mgmt_delete_key(), sec_key_mgmt_delete_key_type().
Contents | Next section | Index |