MpUpdateStart-Funktion
Startet einen Signaturaktualisierungsvorgang.
Syntax
HRESULT WINAPI MpUpdateStart(
_In_ MPHANDLE hMpHandle,
_In_ DWORD dwUpdateOptions,
_In_opt_ PMPCALLBACK_INFO pCallbackInfo,
_Out_ PMPHANDLE phUpdateHandle
);
Parameter
-
hMpHandle [in]
-
Typ: MPHANDLE
Behandeln Sie die Schnittstelle des Malware-Schutz-Managers. Dieses Handle wird von der MpManagerOpen-Funktion zurückgegeben.
-
dwUpdateOptions [in]
-
Art: DWORD
Gibt die Option für den Signaturaktualisierungsvorgang an. Es kann sich um einen der folgenden Werte handeln:
Wert Bedeutung - MPUPDATE_OPTION_NONE
Es wird keine bestimmte Option angefordert. - MPUPDATE_OPTION_ASYNC
Der Aktualisierungsvorgang soll asynchron sein, wobei MpUpdateStart unmittelbar nach der erfolgreichen Initiierung des Signaturupdates zurückgegeben wird. (Standardmäßig ist der Aktualisierungsvorgang synchron, was bedeutet, dass MpUpdateStart erst nach Abschluss des Signaturupdates zurückgegeben wird.) - MPUPDATE_OPTION_PROGRESS
Der Aufrufer ist daran interessiert, Statusinformationen zum Signaturupdate über einen Rückruf zu erhalten. - MPUPDATE_OPTION_HTTP
Das Signaturupdate wird durch Herunterladen des vollständigen Signaturpakets von der Microsoft-Sicherheitsportalwebsite ausgeführt. Dies kann als Fallbackoption verwendet werden, wenn beim Client ein Problem beim Herunterladen von Signaturen über Microsoft Update auftritt. - MPUPDATE_OPTION_UNC
Führt signaturupdates mithilfe des direkten Downloads von UNC-Freigaben aus. - MPUPDATE_OPTION_MANAGED
Führt das Signaturupdate mithilfe des WSUS des verwalteten Diensts aus. - MPUPDATE_OPTION_UNMANAGED
Führt das Signaturupdate mithilfe der MU/WU des nicht verwalteten Diensts durch. -
pCallbackInfo [in, optional]
-
Typ: PMPCALLBACK_INFO
Ein Zeiger auf die Rückrufinformationen, die verwendet werden, um den Client mit Änderungen des Signaturupdatestatus (z. B. Start und Abschluss) und Statusinformationen zu füttern. Die MPCALLBACK_DATA , die in der Rückruffunktion zurückgegeben wurde, meldet den aktuellen Updatestatus und statusbezogene Informationen. Im Folgenden ist eine Liste möglicher Rückrufe aufgeführt:
Wert Bedeutung - MPNOTIFY_SIGUPDATE_START
Der Aktualisierungsvorgang wurde gestartet. - MPNOTIFY_SIGUPDATE_COMPLETE
Der Aktualisierungsvorgang wurde abgeschlossen. - MPNOTIFY_SIGUPDATE_SEARCH_START
Die Suche nach Updates wurde gestartet. - MPNOTIFY_SIGUPDATE_SEARCH_COMPLETE
Suchen Sie nach abgeschlossenen Updates. Weitere Informationen sind über MPSIGUPDATE_DATA Struktur verfügbar. - MPNOTIFY_SIGUPDATE_DOWNLOAD_START
Download für Update gestartet. - MPNOTIFY_SIGUPDATE_DOWNLOAD_PROGRESS
Laden Sie Statusinformationen herunter. Weitere Informationen sind über MPSIGUPDATE_DATA Struktur verfügbar. - MPNOTIFY_SIGUPDATE_DOWNLOAD_COMPLETE
Laden Sie den Download herunter, um das Update abzuschließen. Weitere Informationen sind über MPSIGUPDATE_DATA Struktur verfügbar. - MPNOTIFY_SIGUPDATE_INSTALL_START
Die Installation des Updates wurde gestartet. - MPNOTIFY_SIGUPDATE_INSTALL_PROGRESS
Informationen zum Installationsstatus. Weitere Informationen sind über MPSIGUPDATE_DATA Struktur verfügbar. - MPNOTIFY_SIGUPDATE_INSTALL_COMPLETE
Die Installation des Updates wurde abgeschlossen. Weitere Informationen sind über MPSIGUPDATE_DATA Struktur verfügbar. - MPNOTIFY_SIGUPDATE_REQUEST_PROCESSED
Der Antischadsoftwaredienst hat eine Signaturaktualisierungsanforderung verarbeitet. Fehler oder Erfolg wird durch hResult in MPCALLBACK_DATA angezeigt. - MPNOTIFY_SIGUPDATE_REBOOT_REQUIRED
Erfordert einen Neustart, um den Updatevorgang abzuschließen. Fehler oder Erfolg wird durch hResult in MPCALLBACK_DATA angezeigt. - MPNOTIFY_INTERNAL_FAILURE
Beim Signaturaktualisierungsvorgang ist ein generischer Fehler aufgetreten. Das hResult in MPCALLBACK_DATA weist den spezifischen Fehlercode auf. -
phUpdateHandle [out]
-
Typ: PMPHANDLE
Zurückgegebenes Updatehandle, das den aktuell initiierten Signaturupdatevorgang identifiziert. Dieses Handle kann in nachfolgenden Funktionsaufrufen verwendet werden, z. B. zum Steuern des Signaturaktualisierungsvorgangs. Der Handle muss mit der Funktion MpHandleClose geschlossen werden.
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 |
|
| DLL |
|