NAME

pkc_crypto_lookup_algorithm — Returns cryptographic module details

Synopsis

unsigned32 pkc_crypto_lookup_algorithm(
gss_OID oid,
pkc_signature_algorithm_t ∗details);

Parameters

Input

oidAn OID identifying the algorithm about which details are desired. 

Output

detailsA pointer to an algorithm implementation descriptor block for the specified algorithm. 

Description

pkc_crypto_lookup_algorithm(3sec) returns a pointer to an algorithm implementation descriptor block for the specified cryptographic algorithm, and leaves the algorithm list unlocked. Calling this routine is the recommended way of obtaining information about a registered algorithm implementation. 

The complete list of registered algorithms may be obtained by calling pkc_crypto_get_registered_algorithms(3sec). 

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_register_signature_alg(3sec), pkc_crypto_sign(3sec), pkc_crypto_verify_signature(3sec).