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

cssm_CcToHandle

 » Table of Contents

 » Glossary

 » Index

NAME

cssm_CcToHandle — Get the module attach handle (CDSA)

SYNOPSIS

# include <cssm.h> 
CSSM_RETURN CSSMAPI cssm_CcToHandle
(CSSM_CC_HANDLE Cc,
CSSM_MODULE_HANDLE_PTR ModuleHandle)

LIBRARY

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

PARAMETERS

Cc (input) 

A handle identifying a cryptographic context.

ModuleHandle (output)
  

A service provider's module attach handle. This value will be set to CSSM_INVALID_HANDLE if the function fails.

DESCRIPTION

This function returns the module attach handle identifying the service module that is managing the specified cryptographic context.

The entry point to this function is provided to a service module in a table of upcall functions passed to the service provider during module attach processing.

If the PVC checking for service providers is on, the service provider has to introduce itself before calling this function.

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.

SEE ALSO

Books

Intel CDSA Application Developer's Guide