RegisterDispatchTable

If both a Table of Contents and Search form are not displayed in separate frames along with this one, you may wish to redisplay this book in a frameset, beginning with the first page.

HP Open Source Security for OpenVMS Volume 1:...

Elective Module Manager APIs

RefreshFunctionTable

Terminate

RegisterDispatchTable

Parameters
Return Value
See Also

Description
Errors

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.