IAntimalwareProvider2::Notify-Methode (amsi.h)
Sendet eine Benachrichtigung über einen beliebigen Vorgang an den Antischadsoftwareanbieter. Die Benachrichtigung impliziert nicht die Anforderung einer Antivirenüberprüfung. Stattdessen wurde IAntimalwareProvider2::Notify entwickelt, um einen schnellen und einfachen Mechanismus bereitzustellen, um dem Antischadsoftwareanbieter zu kommunizieren, dass ein Ereignis stattgefunden hat. Im Allgemeinen sollte der Antischadsoftwareanbieter 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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | amsi.h |