HP Open Source Security for OpenVMS Volume 1: Common Data Security Architecture > CDSA API Functions

GenerateKeyPairP

 » Table of Contents

 » Glossary

 » Index

NAME

GenerateKeyPairP — Generate an asymmetric key pair with privilege (CDSA)

SYNOPSIS

# include <cssm.h>
CSSM_RETURN CSSMAPI CSSM_GenerateKeyPairP
(CSSM_CC_HANDLE CCHandle,
uint32 PublicKeyUsage,
uint32 PublicKeyAttr,
const CSSM_DATA *PublicKeyLabel,
CSSM_KEY_PTR PublicKey,
uint32 PrivateKeyUsage,
uint32 PrivateKeyAttr,
const CSSM_DATA *PrivateKeyLabel,
const CSSM_RESOURCE_CONTROL_CONTEXT *CredAndAclEntry,
CSSM_KEY_PTR PrivateKey,
CSSM_PRIVILEGE Privilege)

LIBRARY

Common Security Services Manager library (cdsa$incssm300_shr.exe)

PARAMETERS

Privilege (input)
  

The privilege to be applied during the cryptographic operation.

See CSSM_GenerateKeyPair.

DESCRIPTION

This function is similar to the CSSM_GenerateKeyPair() function. It also accepts a USEE tag as a privilege request parameter. CSSM checks that either its own privilege set or the application's privilege set (if the application is signed) includes the tag. If the tag is found and the service provider privilege set indicates that it is supported, the tag is forwarded to the service provider.

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particular error condition. The value CSSM_OK indicates success. All other values represent an error condition.

ERRORS

Errors are described in the CDSA Technical Standard.

CSSMERR_CSP_KEY_LABEL_ALREADY_EXISTS

SEE ALSO

Books

Intel CDSA Application Developer's Guide

Online Help

Functions: CSSM_GenerateKeyPair