NAME

CSSM_ListModules

SYNOPSIS

CSSM_LIST_PTR CSSMAPI CSSM_ListModules
    (CSSM_SERVICE_MASK ServiceMask,
    CSSM_BOOL MatchAll)

DESCRIPTION

This function returns a list containing the GUID/name pair for each of the currently-installed service provider modules that provide services in any of the CSSM functional categories selected in the service mask.

PARAMETERS

ServiceMask (input)

A bit mask selecting the CSSM functional categories of interest for selecting information about potential service provider modules.

MatchAll (input)

A boolean value defining how the multiple bits in the service mask are interpreted. TRUE means the service modules selected must match all service areas specified by the service mask. FALSE means the service module selected must specify one or more of the service areas specified by the service mask.

RETURN VALUE

A pointer to the CSSM_LIST structure containing the GUID/name pair for each of the modules. If the pointer is NULL, an error has occurred; use CSSM_GetError to obtain the error code.

ERRORS

CSSM_NO_ADDIN

No add-ins found.

CSSM_MEMORY_ERROR

Error in memory allocation.

CSSM_NOT_INITIALIZE

CSSM_Init has not been invoked.

CSSM_REGISTRY_ERROR

Registry error.

SEE ALSO

CSSM_GetModuleInfo, CSSM_FreeModuleInfo