HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 6 KRB5 (Kerberos V5) Application Programming Interface

krb5_c_verify_checksum — Verify a checksum

  Table of Contents



C Prototype

krb5_error_code krb5_c_verify_checksum (
krb5_context context,
const krb5_keyblock *key,
krb5_keyusage usage,
const krb5_data *data,
const krb5_checksum *cksum,
krb5_Boolean *valid );


context (input/output) 

The context structure.

key (input)  

The key used to create the data in cksum.

usage (input) 

The key usage.

data (input) 


cksum (input)  

The checksum to verify.

valid (output)  

Non-zero if the checksum verified correctly; zero if it did not.


This routine verifies the checksum of data in cksum that was created with a key using the key usage usage.

Return Values

This routine returns the following KRB5 status codes:

0Successful completion.
KRB5_BAD_ENCTYPEBad encryption type.
KRB5_BAD_MSIZEMessage size is incompatible with encryption type.