MPNOTIFY enumeration

Possible callback notifications.

Syntax

typedef enum tagMPNOTIFY { 
  MPNOTIFY_NONE,
  MPNOTIFY_CALL_START,
  MPNOTIFY_CALL_COMPLETE,
  MPNOTIFY_INTERNAL_FAILURE,
  MPNOTIFY_STATUS_SERVICE_START,
  MPNOTIFY_STATUS_SERVICE_RUNNING,
  MPNOTIFY_STATUS_SERVICE_STOP,
  MPNOTIFY_STATUS_COMPONENT,
  MPNOTIFY_STATUS_CHANGE,
  MPNOTIFY_STATUS_COMPONENT_CONFIGURATION,
  MPNOTIFY_STATUS_EXPIRATION_CHANGE,
  MPNOTIFY_STATUS_OFFLINE_SCAN_CHANGE,
  MPNOTIFY_SCAN_START,
  MPNOTIFY_SCAN_PAUSED,
  MPNOTIFY_SCAN_RESUMED,
  MPNOTIFY_SCAN_CANCEL,
  MPNOTIFY_SCAN_COMPLETE,
  MPNOTIFY_SCAN_PROGRESS,
  MPNOTIFY_SCAN_ERROR,
  MPNOTIFY_SCAN_INFECTED,
  MPNOTIFY_SCAN_MEMORYSTART,
  MPNOTIFY_SCAN_MEMORYCOMPLETE,
  MPNOTIFY_SCAN_SFC_BUILD_START,
  MPNOTIFY_SCAN_SFC_BUILD_COMPLETE,
  MPNOTIFY_SCAN_FASTPATH_START,
  MPNOTIFY_SCAN_FASTPATH_COMPLETE,
  MPNOTIFY_SCAN_FASTPATH_PROGRESS,
  MPNOTIFY_CLEAN_START,
  MPNOTIFY_CLEAN_COMPLETE,
  MPNOTIFY_CLEAN_RESTOREPOINT_START,
  MPNOTIFY_CLEAN_RESTOREPOINT_SUCCEEDED,
  MPNOTIFY_CLEAN_RESTOREPOINT_FAILED,
  MPNOTIFY_CLEAN_THREAT_START,
  MPNOTIFY_CLEAN_THREAT_SUCCEEDED,
  MPNOTIFY_CLEAN_THREAT_FAILED,
  MPNOTIFY_CLEAN_RESOURCE_SUCCEEDED,
  MPNOTIFY_CLEAN_RESOURCE_FAILED,
  MPNOTIFY_CLEAN_THREAT_COMPLETE,
  MPNOTIFY_PRECHECK_START,
  MPNOTIFY_PRECHECK_COMPLETE,
  MPNOTIFY_PRECHECK_RESOURCE_BLOCKED,
  MPNOTIFY_THREAT_DETECTED,
  MPNOTIFY_THREAT_MODIFIED,
  MPNOTIFY_THREAT_CLEAN_SUCCEEDED,
  MPNOTIFY_THREAT_CLEAN_FAILED,
  MPNOTIFY_THREAT_ABANDONED,
  MPNOTIFY_THREAT_CLEAN_EVENT_START,
  MPNOTIFY_THREAT_CLEAN_EVENT_COMPLETE,
  MPNOTIFY_SIGUPDATE_START,
  MPNOTIFY_SIGUPDATE_SEARCH_START,
  MPNOTIFY_SIGUPDATE_SEARCH_COMPLETE,
  MPNOTIFY_SIGUPDATE_SOFTWARE_UPDATE_AVAILABLE,
  MPNOTIFY_SIGUPDATE_DOWNLOAD_START,
  MPNOTIFY_SIGUPDATE_DOWNLOAD_PROGRESS,
  MPNOTIFY_SIGUPDATE_DOWNLOAD_COMPLETE,
  MPNOTIFY_SIGUPDATE_INSTALL_START,
  MPNOTIFY_SIGUPDATE_INSTALL_PROGRESS,
  MPNOTIFY_SIGUPDATE_INSTALL_COMPLETE,
  MPNOTIFY_SIGUPDATE_REBOOT_REQUIRED,
  MPNOTIFY_SIGUPDATE_REQUEST_PROCESSED,
  MPNOTIFY_SIGUPDATE_COMPLETE,
  MPNOTIFY_SAMPLE_START,
  MPNOTIFY_SAMPLE_COMPLETE,
  MPNOTIFY_SAMPLE_ITEM_START,
  MPNOTIFY_SAMPLE_ITEM_SUCCEEDED,
  MPNOTIFY_SAMPLE_ITEM_FAILED,
  MPNOTIFY_RESERVED_DATA,
  MPNOTIFY_FASTPATH_SIG_ADDED,
  MPNOTIFY_FASTPATH_SIG_REMOVED,
  MPNOTIFY_NIS_PRIVATE,
  MPNOTIFY_HEALTH_CHANGE,
  MPNOTIFY_HEALTH_RECOVERY,
  MPNOTIFY_HEALTH_START,
  MPNOTIFY_ENDOFLIFE_CHANGE,
  MPNOTIFY_MALWARETOAST_DATA
} MPNOTIFY, *PMPNOTIFY;

Constants

MPNOTIFY_NONE

MPNOTIFY_CALL_START

Notification call start.

MPNOTIFY_CALL_COMPLETE

Notification call completed.

MPNOTIFY_INTERNAL_FAILURE

Generic internal failure.

MPNOTIFY_STATUS_SERVICE_START

Malware protection service has started.

MPNOTIFY_STATUS_SERVICE_RUNNING

Malware protection service is running.

MPNOTIFY_STATUS_SERVICE_STOP

Malware protection service has stopped.

MPNOTIFY_STATUS_COMPONENT

Particular component enable/disable status.

MPNOTIFY_STATUS_CHANGE

Overall product status has changed. Call MpManagerStatusQueryEx to obtain the current status.

MPNOTIFY_STATUS_COMPONENT_CONFIGURATION

A particular component has changed configuration.

MPNOTIFY_STATUS_EXPIRATION_CHANGE

Product expiration status has changed.

MPNOTIFY_STATUS_OFFLINE_SCAN_CHANGE

Offline scan required state changed.

MPNOTIFY_SCAN_START

Scan started.

MPNOTIFY_SCAN_PAUSED

Scan paused.

MPNOTIFY_SCAN_RESUMED

scan resumed.

MPNOTIFY_SCAN_CANCEL

Scan cancelled.

MPNOTIFY_SCAN_COMPLETE

Scan completed.

MPNOTIFY_SCAN_PROGRESS

Progress notification for the specific resource being scanned.

MPNOTIFY_SCAN_ERROR

Failure to scan a particular resource. Scan will still continue.

MPNOTIFY_SCAN_INFECTED

Scan found an infected resource.

MPNOTIFY_SCAN_MEMORYSTART

Scan progress to notify memory scan portion of the system scan has started.

MPNOTIFY_SCAN_MEMORYCOMPLETE

Scan progress to notify memory scan portion of the system scan has completed.

MPNOTIFY_SCAN_SFC_BUILD_START

Scan progress to notify sfc build portion has started.

MPNOTIFY_SCAN_SFC_BUILD_COMPLETE

Scan progress to notify sfc build portion has completed.

MPNOTIFY_SCAN_FASTPATH_START

Scan fastpath spynet has begun.

MPNOTIFY_SCAN_FASTPATH_COMPLETE

Scan fastpath spynet has ended.

MPNOTIFY_SCAN_FASTPATH_PROGRESS

Progress notification for fastpath rescans, used internally and converted to MPNOTIFY_SCAN_PROGRESS for external.

MPNOTIFY_CLEAN_START

Cleaning started.

MPNOTIFY_CLEAN_COMPLETE

Cleaning completed.

MPNOTIFY_CLEAN_RESTOREPOINT_START

Started to create a system restore point.

MPNOTIFY_CLEAN_RESTOREPOINT_SUCCEEDED

System restore point successfully created.

MPNOTIFY_CLEAN_RESTOREPOINT_FAILED

System restore point creation failed.

MPNOTIFY_CLEAN_THREAT_START

Cleaning is started for a particular threat.

MPNOTIFY_CLEAN_THREAT_SUCCEEDED

Cleaning is succeeded for a particular threat.

MPNOTIFY_CLEAN_THREAT_FAILED

Cleaning has failed for a particular threat. ERROR_MP_THREAT_NOT_FOUND error code indicates that the threat was not found (and was not a failure to clean).

MPNOTIFY_CLEAN_RESOURCE_SUCCEEDED

Cleaning is succeeded for a particular resource.

MPNOTIFY_CLEAN_RESOURCE_FAILED

Cleaning has failed for a particular resource.

MPNOTIFY_CLEAN_THREAT_COMPLETE

Cleaning has completed for a particular threat.

MPNOTIFY_PRECHECK_START

Clean precheck started.

MPNOTIFY_PRECHECK_COMPLETE

Clean precheck completed.

MPNOTIFY_PRECHECK_RESOURCE_BLOCKED

Clean precheck detected blocked resource.

MPNOTIFY_THREAT_DETECTED

New threat detected in system.

MPNOTIFY_THREAT_MODIFIED

Threat information modified. For example, a new resource was added.

MPNOTIFY_THREAT_CLEAN_SUCCEEDED

Cleaning action succeeded for a threat.

MPNOTIFY_THREAT_CLEAN_FAILED

Cleaning action failed for a threat. ERROR_MP_THREAT_NOT_FOUND error code indicates that the threat was not found (and was not a failure to clean).

MPNOTIFY_THREAT_ABANDONED

No remediation occurred before the service was stopped.

MPNOTIFY_THREAT_CLEAN_EVENT_START

A cleaning action has been started.

MPNOTIFY_THREAT_CLEAN_EVENT_COMPLETE

A cleaning action has ended.

MPNOTIFY_SIGUPDATE_START

Signature update started.

MPNOTIFY_SIGUPDATE_SEARCH_START

Search for updates started.

MPNOTIFY_SIGUPDATE_SEARCH_COMPLETE

Search for updates completed.

MPNOTIFY_SIGUPDATE_SOFTWARE_UPDATE_AVAILABLE

Software update available.

MPNOTIFY_SIGUPDATE_DOWNLOAD_START

Download started.

MPNOTIFY_SIGUPDATE_DOWNLOAD_PROGRESS

Download in progress. Callback data contains progress.

MPNOTIFY_SIGUPDATE_DOWNLOAD_COMPLETE

Download completed.

MPNOTIFY_SIGUPDATE_INSTALL_START

Installation started.

MPNOTIFY_SIGUPDATE_INSTALL_PROGRESS

Installation in progress. Callback data contains progress.

MPNOTIFY_SIGUPDATE_INSTALL_COMPLETE

Installation complete.

MPNOTIFY_SIGUPDATE_REBOOT_REQUIRED

Update requires reboot.

MPNOTIFY_SIGUPDATE_REQUEST_PROCESSED

Service processed a signature update request. Failure or success is indicated by hResult in the callback data.

MPNOTIFY_SIGUPDATE_COMPLETE

Update complete. S_FALSE status indicates that no updates were needed.

MPNOTIFY_SAMPLE_START

Sample submission started.

MPNOTIFY_SAMPLE_COMPLETE

Sample submission completed.

MPNOTIFY_SAMPLE_ITEM_START

Specific sample item submission started. Sample item index is available in MPSAMPLE_DATA.

MPNOTIFY_SAMPLE_ITEM_SUCCEEDED

Specific sample item submission succeeded.

MPNOTIFY_SAMPLE_ITEM_FAILED

Specific sample item submission failed. Error code is available in MPCALLBACK_DATA.

MPNOTIFY_RESERVED_DATA

Internal reserved data.

MPNOTIFY_FASTPATH_SIG_ADDED

A Fastpath signature has either added or disabled a signature.

MPNOTIFY_FASTPATH_SIG_REMOVED

A FastPath signature has been removed.

MPNOTIFY_NIS_PRIVATE

NIS private notifcations. No partners should register for this.

MPNOTIFY_HEALTH_CHANGE

The AM service has entered a new state.

MPNOTIFY_HEALTH_RECOVERY

The AM service has recovered from a state.

MPNOTIFY_HEALTH_START

The AM service has initialized the health of the system.

MPNOTIFY_ENDOFLIFE_CHANGE

The "End Of Life" expiry dates for the AM service have changed.

MPNOTIFY_MALWARETOAST_DATA

The AM service has encountered malware that might have caused critical settings change in the machine.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Header	MpClient.h

See also

MpManagerStatusQueryEx

MPCALLBACK_DATA

MPSAMPLE_DATA