NAME

CSSM_ModuleManagerInstall

SYNOPSIS

CSSM_RETURN CSSMAPI CSSM_ModuleManagerInstall
    (const char *ModuleManagerName,
    const char *ModuleManagerFileName,
    const char *ModuleManagerPathName,
    const CSSM_SERVICE_MASK ModuleManagerType,
    const CSSM_MODULE_MANAGER_INFO ModuleManagerDescription,
    const void *Reserved1,
    const CSSM_DATA_PTR Reserved2)

DESCRIPTION

This function registers the elective module manager with CSSM. CSSM adds the manager's descriptive information to its persistent registry. This makes the add-in service modules managed by this manager available for use on the local system. The function accepts as input the name and unique identifier for the module manager, the location executable code for the manager, and the service category supported by the manager.

PARAMETERS

ModuleManagerName (input)

The name of the module manager.

ModuleManagerFileName (input)

The name of the file that implements the module manager.

ModuleManagerPathName (input)

The path to the file that implements the module manager.

ModuleManagerGuid (input)

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

ModuleManagerType (input)

A CSSM_SERVICE_MASK defining the security service category supported by the module manager. This mask must be unique.

ModuleManagerDescription (input)

A pointer to the CSSM_MODULE_MANAGER_INFO structure containing a description of the module manager.

Reserved1 (input)

Reserve data for the function.

Reserved2 (input)

Reserve data for the function.

RETURN VALUE

A CSSM_OK return value signifies that the information has been registered with CSM. If CSSM_FAIL is returned, an error has occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_INVALID_POINTER

Invalid pointer.

CSSM_REGISTRY_ERROR

Error in the registry.

SEE ALSO

CSSM_ModuleManagerUninstall