NAME

CSSM_SetModuleInfo

SYNOPSIS

CSSM_RETURN CSSMAPI CSSM_SetModuleInfo
    (const CSSM_GUID_PTR ModuleGUID,
    const CSSM_MODULE_INFO_PTR ModuleInfo);

DESCRIPTION

This function replaces all of the currently registered descriptive information about the module identified by the ModuleGUID with the newly specified information. The operation is a total replacement of all information for all service categories and all subservices.

If the caller wishes to retain any of the information registered prior to execution of this call, the caller must use the CSSM_GetModuleInfo function to retrieve the current information, update their private copy, and then use the CSSM_SetModuleInfo function to place the updated copy back into the CSSM registry.

This function should be used to incrementally update descriptive information that is unspecified at installation time.

PARAMETERS

ModuleGUID (input)

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

ModuleInfo (input)

A pointer to the complete structured set of descriptive information about the module.

RETURN VALUE

A CSSM_RETURN value indicating pass or fail. CSSM_OK indicates success, otherwise use CSSM_GetError to determine the type of error that has occurred.

ERRORS

CSSM_INVALID_GUID

Unknown GUID.

CSSM_INVALID_MODULE_INFO

Invalid module info structure.

CSSM_MEMORY_ERROR

Internal memory error.

CSSM_NOT_INITIALIZE

CSSM_Init has not been invoked.

CSSM_REGISTRY_ERROR

Registry error.

CSSM_INVALID_POINTER

Invalid input pointer.

SEE ALSO

CSSM_GetModuleInfo, CSSM_FreeModuleInfo