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-definedfunctions the elective module manager can use to query and controlthe state of an attach-session between an application and a serviceprovider 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 typemanaged by the EMM. CSSM uses this function to provide the EMM witha set of CSSM function pointers. The EMM invokes these functionsat anytime during the life cycle of the attach-session to obtaininformation about the current state and to modify the current stateof the attach session.

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

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.

ERRORS

Errors are described in the CDSA Technical Standard.