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

Behandeln eines asynchronen Scanvorgangs. Dieses Handle wird von der MpScanStart-Funktion zurückgegeben. Dieser Parameter kann auch auf das Schnittstellenhandle des Malware-Schutz-Managers festgelegt werden, das von der MpManagerOpen-Funktion zurückgegeben wird, um eine systeminitiierte Überprüfung zu steuern. In diesem Fall muss der Aufrufer über Administratorrechte verfügen.

ScanControl [in]

Typ: MPCONTROL

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

Wert Bedeutung
MPCONTROL_ABORT
Beenden Sie den Scanvorgang.
MPCONTROL_PAUSE
Halten Sie den Scanvorgang an.
MPCONTROL_RESUME
Setzen Sie den angehaltenen Scanvorgang fort.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird 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 allgemeine Beschreibung der Fehlermeldung abzurufen.

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

Siehe auch

MpErrorMessageFormat

MpManagerOpen

MpScanStart