sec_key_mgmt_get_key-Retrieve a principal's key from local storage.
#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);
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.
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().
error_status_ok, sec_key_mgmt_e_authn_invalid, sec_key_mgmt_e_key_unavailable, sec_key_mgmt_e_unauthorized, sec_s_no_memory.
Functions: sec_key_mgmt_free_key().
Contents | Next section | Index |