Edit

SceSvcAttachmentUpdate callback function

  • Article

The SceSvcAttachmentUpdate function is called by the Security Configuration snap-ins to pass configuration changes to the security database.

Syntax

SCESTATUS WINAPI SceSvcAttachmentUpdate(
  _In_ PSCESVC_CALLBACK_INFO     pSceCbInfo,
  _In_ SCESVC_CONFIGURATION_INFO *ServiceInfo
);

Parameters

pSceCbInfo [in]

Pointer to a SCESVC_CALLBACK_INFO structure which contains the callback handle and function pointers to SCE.

ServiceInfo [in]

Updated configuration information. The data structure used for this information is SCESVC_CONFIGURATION_INFO.

Return value

If this function succeeds, it returns SCESTATUS_SUCCESS. Otherwise it returns an error code. For more information about the Security Configuration error codes, see Attachment Return Values.

Remarks

The SceSvcAttachmentUpdate function must do the following:

  • Call the callback function pointed to by the pfQueryInfo member of the SCESVC_CALLBACK_INFO structure (pSceCbInfo->pfQueryInfo) to retrieve the current base configuration information from the security database.
  • Call the callback function pointed to by the pfQueryInfo member of the SCESVC_CALLBACK_INFO structure (pSceCbInfo->pfQueryInfo) to retrieve the last set of differences (analysis information) from the security database.
  • Use the supplied service information (see ServiceInfo) to compute the new base configuration.
  • Use the supplied service information (see ServiceInfo) and the analysis to compute the new difference information.
  • Call the callback function pointed to by the pfSetInfo member of the SCESVC_CALLBACK_INFO structure (pSceCbInfo->pfSetInfo)to set the new base configuration in the security database.
  • Call the callback function pointed to by the pfSetInfo member of the SCESVC_CALLBACK_INFO structure (pSceCbInfo->pfSetInfo) to set the new analysis information in the security database.

For more information, see Implementing SceSvcAttachmentUpdate

Requirements

Requirement Value
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]

See also

SCESVC_CALLBACK_INFO

SCESVC_CONFIGURATION_INFO