NAME

sec_key_mgmt_get_key-Retrieve a principal's key from local storage.

SYNOPSIS

#include <dce/keymgmt.h>

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

PARAMETERS

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 to whom the key belongs.

key_vno

The version number of the desired key.

Output

keydata

The returned key data (see <dce/keymgmt.h>).

status

The completion status.

DESCRIPTION

The sec_key_mgmt_get_key() routine retrieves the specified key from the local key store.

The memory for keydata is dynamically allocated, and is to be freed by sec_key_mgmt_free_key().

ERRORS

error_status_ok, sec_key_mgmt_e_authn_invalid, sec_key_mgmt_e_key_unavailable, sec_key_mgmt_e_unauthorized, sec_s_no_memory.

SEE ALSO

Functions: sec_key_mgmt_free_key().