MpScanStart, funkcja

Uruchamia operację skanowania.

Składnia

HRESULT WINAPI MpScanStart(
  _In_     MPHANDLE          hMpHandle,
  _In_     MPSCAN_TYPE       ScanType,
  _In_     DWORD             dwScanOptions,
  _In_opt_ PMPSCAN_RESOURCES pScanResources,
  _In_opt_ PMPCALLBACK_INFO  pCallbackInfo,
  _Out_    PMPHANDLE         phScanHandle
);

Parametry

hMpHandle [in]

Typ: MPHANDLE

Obsługa interfejsu menedżera ochrony przed złośliwym oprogramowaniem. Ten uchwyt jest zwracany przez funkcję MpManagerOpen .

ScanType [in]

Typ: MPSCAN_TYPE

Określa typ skanowania. Ten parametr musi być jednym z elementów członkowskich wyliczenia MPSCAN_TYPE .

dwScanOptions [in]

Typ: DWORD

Określa różne opcje operacji skanowania.

Wartość	Znaczenie
MPSCAN_OPTION_NONE	Nie jest żądana żadna konkretna opcja.
MPSCAN_OPTION_ASYNC	Operacja skanowania ma być asynchroniczna, w której element MpScanStart jest zwracany natychmiast po pomyślnym zainicjowaniu skanowania. (Domyślnie operacja skanowania jest synchroniczna, co oznacza, że Plik MpScanStart zostanie zwrócony dopiero po zakończeniu skanowania).
MPSCAN_OPTION_PROGRESS	Obiekt wywołujący jest zainteresowany otrzymywaniem informacji o postępie skanowania za pośrednictwem wywołania zwrotnego.
MPSCAN_OPTION_LOWPRIORITY	Przeprowadź skanowanie z niskim priorytetem. (Domyślnie operacja skanowania jest wykonywana z normalnym priorytetem).
MPSCAN_OPTION_PACKEDEXES	Skanuj spakowane pliki wykonywalne pod kątem możliwych zagrożeń.
MPSCAN_OPTION_ARCHIVES	Skanuj zawartość archiwum pod kątem możliwych zagrożeń. Archiwa to pliki z rozszerzeniami, takimi jak .zip, .cablub .tar.
MPSCAN_OPTION_HEURISTICS	Włącz skanowanie oparte na heurystyce. Spowoduje to skanowanie pod kątem zagrożeń z typem wykrywania ustawionym na heurystyki.
MPSCAN_OPTION_REPORTFRIENDLY	Raporty przyjazne elementy w skanowaniu zasobów. Jest to przeznaczone tylko do użytku wewnętrznego.
MPSCAN_OPTION_REPORTUNKNOWN	Zgłaszanie nieznanych elementów w skanowaniu zasobów. Jest to przeznaczone tylko do użytku wewnętrznego.
MPSCAN_OPTION_NOCONSOLIDATE	Nie konsoliduj wyników skanowania za pomocą globalnego widoku zagrożeń. Jest to przydatne w przypadku klienta (takiego jak klient poczty e-mail), który chce kontrolować środowisko użytkownika czyszczenia samodzielnie, a nie zezwalać na domyślne środowisko użytkownika chroniące przed złośliwym oprogramowaniem. Jest to przeznaczone tylko do użytku wewnętrznego.

pScanResources [in, opcjonalnie]

Typ: PMPSCAN_RESOURCES

Wskaźnik do informacji o zasobie skanowania. Ten parametr musi mieć wartość NULL na potrzeby szybkiego skanowania. Jest to opcjonalny parametr pełnego skanowania. W przypadku skanowania zasobów ten parametr musi być określony z co najmniej jedną strukturą informacji o zasobach. Aby skanować określone zasoby, obiekt wywołujący musi mieć GENERIC_READ uprawnienia do zasobu. Zobacz MPSCAN_RESOURCES.

pCallbackInfo [in, opcjonalnie]

Typ: PMPCALLBACK_INFO

Wskaźnik do informacji wywołania zwrotnego używanych do podawania klientowi zmian stanu skanowania (takich jak rozpoczęcie i ukończenie) i informacje o postępie. MPCALLBACK_DATA przekazane z powrotem w funkcji wywołania zwrotnego raportuje rzeczywisty stan skanowania i informacje związane z postępem. Poniżej znajduje się lista możliwych wywołań zwrotnych:

Wartość	Znaczenie
MPNOTIFY_SCAN_START	Rozpoczęto operację skanowania.
MPNOTIFY_SCAN_COMPLETE	Operacja skanowania została ukończona. Dodatkowe informacje są dostępne za pośrednictwem struktury MPSCAN_DATA .
MPNOTIFY_SCAN_PAUSED	Operacja skanowania jest wstrzymana.
MPNOTIFY_SCAN_RESUMED	Operacja skanowania została wznowiona z wstrzymania.
MPNOTIFY_SCAN_CANCEL	Operacja skanowania została anulowana.
MPNOTIFY_SCAN_PROGRESS	Skanuj informacje o postępie. Dodatkowe informacje (takie jak statystyki zasobów) są dostępne za pośrednictwem struktury MPSCAN_DATA .
MPNOTIFY_SCAN_ERROR	Skanuj informacje o błędzie dla określonego zasobu. Określone informacje o zasobach są dostępne za pośrednictwem struktury MPSCAN_DATA .
MPNOTIFY_SCAN_INFECTED	Skanowanie wykryło zainfekowany zasób. Należy pamiętać, że w większości przypadków spowoduje to zgłoszenie pewnego zagrożenia na końcu skanowania. Czasami może nie zmaterializować się jako zagrożenie ze względu na wykluczenia. Dodatkowe zainfekowane informacje o zasobach są dostępne za pośrednictwem struktury MPSCAN_DATA .
MPNOTIFY_SCAN_MEMORYSTART	Rozpoczęto szybkie skanowanie części pełnego skanowania.
MPNOTIFY_SCAN_MEMORYCOMPLETE	Zakończono szybkie skanowanie części pełnego skanowania.
MPNOTIFY_INTERNAL_FAILURE	Operacja skanowania napotkała błąd ogólny. HResult w MPCALLBACK_DATA ma określony kod błędu.

phScanHandle [out]

Typ: PMPHANDLE

Zwrócony uchwyt skanowania, który identyfikuje aktualnie zainicjowane skanowanie. Ten uchwyt może być używany w kolejnych wywołaniach funkcji, takich jak pobieranie wyniku skanowania. Uchwyt musi zostać zamknięty za pomocą funkcji MpHandleClose .

Wartość zwracana

Typ: HRESULT

Jeśli funkcja powiedzie się, zwracana wartość jest S_OK.

Jeśli funkcja nie powiedzie się, zwracana wartość jest kodem HRESULT , który zakończył się niepowodzeniem. Obiekt wywołujący może użyć funkcji MpErrorMessageFormat , aby uzyskać ogólny opis komunikatu o błędzie.

Wymagania

Zobacz także

MpErrorMessageFormat

MpHandleClose

MpManagerOtwórz

MPCALLBACK_DATA

MPSCAN_DATA

MPSCAN_RESOURCES

MPSCAN_TYPE