Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

sec_key_mgmt_get_next_kvno-Retrieve the next eligible key version number for a key.

SYNOPSIS

#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);

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 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.

DESCRIPTION

The sec_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).

ERRORS

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.

SEE ALSO

Protocols: rs_acct_lookup().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index