skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 1:... HP Open Source Security for OpenVMS Volume 1:...
go to beginning of reference: API FunctionsAPI Functions
go to previous page: MDSUTIL_ListModuleManagersMDSUTIL_ListModuleManagers
go to next page: MDSUTIL_ModuleInstallMDSUTIL_ModuleInstall
end of book navigation links


MDSUTIL_ListModules
Library
Description
Errors
 Parameters
Return Value
See Also

NAME

MDSUTIL_ListModules - Returns a list containing the GUID/version/name foreach of the currently installed service provider modules that provideservices in any of the CSSM functional categories selected in theusage mask. The MDSUTIL_FreeModuleList function must be called todeallocate memory containing the list.

SYNOPSIS  

# include <mds_util_api.h>
#include <mds_util_helper.h>

CSSM_RETURN CSSMAPI MDSUTIL_ListModules (CSSM_SERVICE_MASK UsageMask,CSSM_BOOL MatchAll,MDSUTIL_LIST_PTR *pList)


return to top LIBRARY  

Module Directory Services library (cdsa$mds300_shr.exe)


return to top PARAMETERS  

UsageMask (input)
 A bit mask selecting CSSM functional categoriesof interest for selecting information about potential service providermodules.
MatchAll (input)
 A Boolean value to indicate if the add-in has tomatch all of the conditions expressed in UsageMask. TRUE means allconditions must be met. FALSE means one or more conditions mustbe met.
pList (output)
 Pointer to a list of modules. Each item containsa CSSM_GUID, the module version, and a descriptive string name ofthe module.


return to top DESCRIPTION  

This function returns a list containing the GUID/version/namefor each of the currently installed service provider modules thatprovide services in any of the CSSM functional categories selectedin the usage mask. The MDSUTIL_FreeModuleList function must be calledto deallocate memory containing the list.


return to top RETURN VALUE  

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


return to top ERRORS  

Errors are described in the CDSA Technical Standard.
CSSM_ERRCODE_MDS_ERROR

CSSMERR_CSSM_INVALID_POINTER

CSSM_ERRCODE_INVALID_OUTPUT_POINTER

CSSM_ERRCODE_MEMORY_ERROR

CSSMERR_NOT_INITIALIZED


return to top SEE ALSO  

Books

Intel CDSA Application Developer's Guide

Online Help

Functions: MDSUTIL_ModuleInstall, MDSUTIL_ModuleUninstall, MDSUTIL_GetModuleInfo, MDSUTIL_GetCredLocationFromGUID, MDSUTIL_FreeModuleInfo, MDSUTIL_FreeModuleList, MDSUTIL_ListModuleManagers, MDSUTIL_GetModuleManagerInfo, MDSUTIL_ModuleManagerInstall, MDSUTIL_ModuleManagerUninstall, MDSUTIL_Init, MDSUTIL_Term


go to previous page: MDSUTIL_ListModuleManagersMDSUTIL_ListModuleManagers
go to next page: MDSUTIL_ModuleInstallMDSUTIL_ModuleInstall