sec_key_mgmt_get_next_kvno-Retrieve the next eligible key version number for a key.
#include <dce/keymgmt.h>
void sec_key_mgmt_get_next_kvno(
sec_key_mgmt_authn_service authn_service,
void *get_key_fn_arg,
idl_char *principal_name,
void *keytype,
unsigned32 *key_vno,
unsigned32 *next_key_vno,
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 associated with the key.
- keytype
Indicates the key type (see<dce/keymgmt.h> ).
Input/Output
- key_vno
The current version number of the key. Specifying NULL prevents this value from being returned.
- next_key_vno
The next eligible version number for the key. Specifying NULL prevents this value from being returned.
Output
- status
The completion status.
Thesec_key_mgmt_get_next_kvno() routine returns the current and next eligible version numbers for a key from the registry server (not from the local key table).
error_status_ok, sec_key_mgmt_e_authn_invalid, sec_key_mgmt_e_key_unavailable, sec_key_mgmt_e_unauthorized, sec_rgy_object_not_found, sec_rgy_server_unavailable.
Protocols:rs_acct_lookup() .
Contents | Next section | Index |