HP OpenVMS Systems Documentation

Content starts here
HP Open Source Security for OpenVMS Volume 1: Common Data Security Architecture > Elective Module Manager (EMM) API Functions

RegisterDispatchTable

  Table of Contents

  Glossary

  Index

NAME

RegisterDispatchTable — Provide the EMM with CSSM function pointers

SYNOPSIS

# include <cssm.h>
CSSM_RETURN CSSMAPI RegisterDispatchTable
(CSSM_STATE_FUNCS_PTR CssmStateCallTable)

PARAMETERS

CssmStateCallTable (input)
  

A table of function pointers for the set of CSSM-defined functions the elective module manager can use to query and control the state of an attach-session between an application and a service provider managed by the module manager.

DESCRIPTION

This EMM-defined function is invoked by CSSM once for each CSSM_ModuleAttach(), operation requesting a service provider of the type managed by the EMM. CSSM uses this function to provide the EMM with a set of CSSM function pointers. The EMM invokes these functions at anytime during the life cycle of the attach-session to obtain information about the current state and to modify the current state of the attach session.

When the attach-session is terminated, CSSM informs the module manager by invoking the EMM function DeregisterDispatchTable(). The corresponding set of CSSM state functions become invalid at that time.

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

Online Help

Functions: DeregisterDispatchTable