MpScanControl-Funktion

Ermöglicht die Steuerung eines Scans, der asynchron über MpScanStart initiiert wurde.

Syntax

HRESULT WINAPI MpScanControl(
  _In_ MPHANDLE  hScanHandle,
  _In_ MPCONTROL ScanControl
);

Parameter

hScanHandle [ In]

Typ: MPHANDLE

Handle für einen asynchronen Scanvorgang. Dieses Handle wird von der MpScanStart-Funktion zurückgegeben. Dieser Parameter kann auch auf das Handle der Malware Protection Manager-Schnittstelle festgelegt werden, das von der MpManagerOpen-Funktion zurückgegeben wird, um eine vom System initiierte Überprüfung zu steuern. In diesem Fall muss der Aufrufer über Administratorrechte verfügen.

ScanControl [ In]

Typ: MPCONTROL

Gibt eine Scansteuersteueroption an. Dieser Parameter muss eine der folgenden Steuerelementoptionen sein:

Wert Bedeutung
MPCONTROL _ ABORT
Bricht den Scanvorgang ab.
MPCONTROL _ PAUSE
Halten Sie den Überprüfungsvorgang an.
MPCONTROL _ RESUME
Setzen Sie den angehaltenen Scanvorgang wieder auf.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, ist der Rückgabewert S _ OK.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein fehlerhafter HRESULT-Code. Der Aufrufer kann die MpErrorMessageFormat-Funktion verwenden, um eine generische Beschreibung der Fehlermeldung zu erhalten.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
[Windows 8 Nur Desktop-Apps]
Unterstützte Mindestversion (Server)
[Windows Server 2012 Nur Desktop-Apps]
Header
MpClient.h
DLL
MpClient.dll

Weitere Informationen

MpErrorMessageFormat

MpManagerOpen

MpScanStart