NAME

sec_key_mgmt_delete_key_type-Delete a key version of a specified key type from local key store.

SYNOPSIS

#include <dce/keymgmt.h>

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

PARAMETERS

Input

authn_service

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

get_key_fn_arg

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

principal_name

Name of the principal whose key type is to be deleted.

keytype

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

key_vno

Version number of the key to be deleted.

Output

status

The completion status.

DESCRIPTION

The sec_key_mgmt_delete_key_type() routine deletes the specified key version of the specified key type 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(), sec_key_mgmt_garbage_collect().