IAntimalware2::Notify-Methode (amsi.h)
Sendet eine Benachrichtigung über einen beliebigen Vorgang an das Antischadsoftwareprodukt. Die Benachrichtigung impliziert nicht die Anforderung einer Antivirenüberprüfung. Stattdessen ist IAntimalware2::Notify darauf ausgelegt, einen schnellen und einfachen Mechanismus bereitzustellen, um dem Antischadsoftwareprodukt mitzuteilen, dass ein Ereignis stattgefunden hat. Im Allgemeinen sollte das Antischadsoftwareprodukt die Benachrichtigung verarbeiten und so schnell wie möglich zum Aufrufer zurückkehren.
Syntax
HRESULT Notify(
PVOID buffer,
ULONG length,
LPCWSTR contentName,
LPCWSTR appName,
AMSI_RESULT *pResult
);
Parameter
buffer
Typ: PVOID
Der Puffer, der die Benachrichtigungsdaten enthält.
length
Typ: ULONG
Die Länge der Daten, die aus dem Puffer gelesen werden sollen, in Bytes.
contentName
Typ: LPCWSTR
Dateiname, URL, eindeutige Skript-ID oder ähnliches des gescannten Inhalts.
appName
Typ: LPCWSTR
Der Name der Anwendung, die die AMSI-Benachrichtigung sendet.
pResult
Typ: AMSI_RESULT*
Das Ergebnis der Überprüfung.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Erfolg. |
| E_INVALIDARG | Mindestens ein Argument ist ungültig. |
| E_NOT_VALID_STATE | Das Objekt wird nicht initialisiert. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | amsi.h |