NAME

sec_key_mgmt_delete_key-Delete specified keys from local key store.

SYNOPSIS

#include <dce/keymgmt.h>

void sec_key_mgmt_delete_key(
    sec_key_mgmt_authn_service authn_service,
    void *get_key_fn_arg,
    idl_char *principal_name,
    unsigned32 key_vno,
    error_status_t *status);

PARAMETERS

Input

authn_service

Identifies the authentication service appropriate for the keys to be deleted.

get_key_fn_arg

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

principal_name

Name of the principal whose key is to be deleted.

key_vno

Version number of key to be deleted.

Output

status

The completion status.

DESCRIPTION

The sec_key_mgmt_delete_key() routine deletes the specified keys (namely, those of the specified key version number, of all key types) from the local key store, thereby "revoking" all extant tickets protected with those keys.

Any error condition leaves the key state unchanged.

ERRORS

error_status_ok, sec_key_mgmt_e_authn_invalid, sec_key_mgmt_e_key_unavailable, sec_key_mgmt_e_unauthorized.

SEE ALSO

Functions: sec_key_mgmt_delete_key_type(), sec_key_mgmt_garbage_collect().