Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

sec_key_mgmt_garbage_collect-Delete unusable keys from local key store.

SYNOPSIS

#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);

PARAMETERS

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.

DESCRIPTION

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.

ERRORS

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.

SEE ALSO

Functions: sec_key_mgmt_delete_key(), sec_key_mgmt_delete_key_type().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index