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

  Glossary

  Index

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

Arguments

context (input/output) 

The context structure.

key (input)  

The key used to create the data in cksum.

usage (input) 

The key usage.

data (input) 

Data.

cksum (input)  

The checksum to verify.

valid (output)  

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

Description

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.