NAME

CSSM_RegisterServices

SYNOPSIS

CSSM_RETURN CSSMAPI CSSM_RegisterServices
    (const CSSM_GUID_PTR GUID,
    const CSSM_REGISTRATION_INFO_PTR FunctionTable,
    CSSM_SPI_MEMORY_FUNCS_PTR UpcallTable,
    void *Reserved)

DESCRIPTION

This function is used by an add-in module to register its function table with CSSM and to receive a memory management upcall table from CSSM.

PARAMETERS

GUID (input)

A pointer to the CSSM_GUID structure containing the global unique identifier for the calling module.

FunctionTable (input)

A structure containing pointers to the interface functions implemented by this module, organized by interface type.

UpcallTable (output)

A pointer to the CSSM_SPI_MEMORY_FUNCS structure containing the memory management function pointers to be used by this module.

Reserved (input)

A reserved input.

RETURN VALUE

CSSM_OK if the function was successful. CSSM_FAIL if an error condition occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_INVALID_GUID

Invalid GUID.

CSSM_REGISTER_SERVICES_FAIL

Unable to register services.

CSSM_INVALID_POINTER

Invalid input pointer.

CSSM_MEMORY_ERROR

Internal Memory Error.

SEE ALSO

CSSM_DeregisterServices