NAME

CSSM_GetInfo

SYNOPSIS

CSSM_CSSMINFO_PTR CSSMAPI CSSM_GetInfo
    ( const CSSM_MEMORY_FUNCS_PTR MemoryFunctions,
      uint32 *NumCssmInfos)

DESCRIPTION

This function returns the version information of all the CSSM instances installed/registered on the local system. Memory to hold the info structure is obtaining using the memory allocation functions. The list the list is no loner needed it can be de-allocated by invoking the CSSM_FreeInfo function or the caller can de-allocate the list directly.

PARAMETERS

MemoryFunctions (input)

A table of API_MEMORY_FUNCTION pointers for use by the CSSM representative. The representative uses the memory allocation function to obtain memory to hold a CSSM information structure for each CSSM installed on the local system.

NumCssmInfos (output)

The number of CSSM instances installed on the local system and the number of information structures returned by this function.

RETURN VALUE

A pointer to an array of CSSM_CSSMINFO structures. If the pointer is NULL, an error occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_MEMORY_ERROR

Error in allocating memory.

CSSM_NOT_INSTALLED

No CSSM as not been installed.

SEE ALSO

CSSM_FreeInfo,
CSSM_Load