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

Siehe auch

MpErrorMessageFormat

MpManagerOpen

MpScanStart