PreviousNext

pkc_crypto_register_signature_alg(3sec)

Registers a signature algorithm module

Synopsis

#include <dce/pkc_base.h>

#include <dce/pkc_crypto_reg.h>

unsigned32 pkc_crypto_register_signature_alg(

pkc_signature_algorithm_t * alg,

int replacement_policy);

Parameters

Input

alg
A pointer to the signature algorithm module structure to be registered.

replacement_policy
Specifies how the registration is to be handled if an implementation of the algorithm is already registered. There are three possible values:
PKC_REPLACE_NONE
Specifies that an error should be returned if an implementation of the algorithm is already registered.
PKC_REPLACE_ENTRYPOINTS
Specifies that only entry points that the original implementation (if any) did not provide should be replaced. (Note that this value is not currently supported.)
PKC_REPLACE_ALL
Specifies that the new implementation should replace the existing one, if any.

Description

pkc_crypto_register_signature_alg(3sec) registers a signature algorithm module, in the form of a properly declared pkc_signature_algorithm_t data structure, which contains identifying information about the module as well as entry points to all of the module's functions.

Calling this routine will cause the module passed to it to be registered as a cryptographic module; it can then be accessed by other applications via the high level certification API routines.

Return Values

pkc_s_success
Operation successfully completed.

Errors

Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

Related Information

Functions:
pkc_crypto_generate_keypair(3sec)
pkc_crypto_get_registered_algorithms(3sec)
pkc_crypto_lookup_algorithm(3sec)
pkc_crypto_sign(3sec)
pkc_crypto_verify_signature(3sec)