Funzione MpUpdateStart
Avvia un'operazione di aggiornamento della firma.
Sintassi
HRESULT WINAPI MpUpdateStart(
_In_ MPHANDLE hMpHandle,
_In_ DWORD dwUpdateOptions,
_In_opt_ PMPCALLBACK_INFO pCallbackInfo,
_Out_ PMPHANDLE phUpdateHandle
);
Parametri
-
hMpHandle [in]
-
Tipo: MPHANDLE
Gestire l'interfaccia di Gestione protezione malware. Questo handle viene restituito dalla funzione MpManagerOpen .
-
dwUpdateOptions [in]
-
Tipo: DWORD
Specifica l'opzione per l'operazione di aggiornamento della firma. Può essere uno dei valori seguenti:
Valore Significato - MPUPDATE_OPTION_NONE
Non è richiesta alcuna opzione specifica. - MPUPDATE_OPTION_ASYNC
L'operazione di aggiornamento deve essere asincrona, in cui MpUpdateStart restituisce immediatamente dopo l'avvio corretto dell'aggiornamento della firma. Per impostazione predefinita, l'operazione di aggiornamento è sincrona, ovvero MpUpdateStart restituirà solo dopo il completamento dell'aggiornamento della firma. - MPUPDATE_OPTION_PROGRESS
Il chiamante è interessato alla ricezione delle informazioni sullo stato di avanzamento dell'aggiornamento della firma tramite un callback. - MPUPDATE_OPTION_HTTP
L'aggiornamento della firma viene eseguito scaricando il pacchetto di firma completo dal sito del portale di sicurezza Microsoft. Questa opzione può essere usata come opzione di fallback se il client riscontra un problema di download della firma tramite Microsoft Update. - MPUPDATE_OPTION_UNC
Esegue l'aggiornamento della firma usando il download diretto dalle condivisioni UNC. - MPUPDATE_OPTION_MANAGED
Esegue l'aggiornamento della firma usando Managed Service WSUS. - MPUPDATE_OPTION_UNMANAGED
Esegue l'aggiornamento della firma usando mu/WU del servizio non gestito. -
pCallbackInfo [in, facoltativo]
-
Tipo: PMPCALLBACK_INFO
Puntatore alle informazioni di callback usate per inviare al client modifiche dello stato di aggiornamento delle firme, ad esempio inizio e completamento, e informazioni sullo stato di avanzamento. Il MPCALLBACK_DATA passato nella funzione callback segnala lo stato di aggiornamento effettivo e le informazioni correlate allo stato di avanzamento. Di seguito è riportato un elenco di possibili callback:
Valore Significato - MPNOTIFY_SIGUPDATE_START
Operazione di aggiornamento avviata. - MPNOTIFY_SIGUPDATE_COMPLETE
Operazione di aggiornamento completata. - MPNOTIFY_SIGUPDATE_SEARCH_START
Cercare gli aggiornamenti avviati. - MPNOTIFY_SIGUPDATE_SEARCH_COMPLETE
Cercare gli aggiornamenti completati. Altre informazioni sono disponibili tramite MPSIGUPDATE_DATA struttura. - MPNOTIFY_SIGUPDATE_DOWNLOAD_START
Scaricare per l'aggiornamento avviato. - MPNOTIFY_SIGUPDATE_DOWNLOAD_PROGRESS
Scaricare le informazioni sullo stato di avanzamento. Altre informazioni sono disponibili tramite MPSIGUPDATE_DATA struttura. - MPNOTIFY_SIGUPDATE_DOWNLOAD_COMPLETE
Scaricare per il completamento dell'aggiornamento. Altre informazioni sono disponibili tramite MPSIGUPDATE_DATA struttura. - MPNOTIFY_SIGUPDATE_INSTALL_START
Installazione dell'aggiornamento avviato. - MPNOTIFY_SIGUPDATE_INSTALL_PROGRESS
Informazioni sullo stato di avanzamento dell'installazione. Altre informazioni sono disponibili tramite MPSIGUPDATE_DATA struttura. - MPNOTIFY_SIGUPDATE_INSTALL_COMPLETE
Installazione dell'aggiornamento completata. Altre informazioni sono disponibili tramite MPSIGUPDATE_DATA struttura. - MPNOTIFY_SIGUPDATE_REQUEST_PROCESSED
Il servizio antimalware ha elaborato una richiesta di aggiornamento della firma. Errore o esito positivo è indicato da hResult in MPCALLBACK_DATA. - MPNOTIFY_SIGUPDATE_REBOOT_REQUIRED
Richiede il riavvio per completare l'operazione di aggiornamento. Errore o esito positivo è indicato da hResult in MPCALLBACK_DATA. - MPNOTIFY_INTERNAL_FAILURE
L'operazione di aggiornamento della firma ha rilevato un errore generico. HResult in MPCALLBACK_DATA ha il codice di errore specifico. -
phUpdateHandle [out]
-
Tipo: PMPHANDLE
Handle di aggiornamento restituito che identifica l'operazione di aggiornamento della firma attualmente avviata. Questo handle può essere usato nelle chiamate di funzione successive, ad esempio per controllare l'operazione di aggiornamento delle firme. L'handle deve essere chiuso con la funzione MpHandleClose .
Valore restituito
Tipo: HRESULT
Se la funzione ha esito positivo, il valore restituito è S_OK.
Se la funzione ha esito negativo, il valore restituito è un codice HRESULT non riuscito. Il chiamante può usare la funzione MpErrorMessageFormat per ottenere una descrizione generica del messaggio di errore.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 8 [solo app desktop] |
| Server minimo supportato |
Windows Server 2012 [solo app desktop] |
| Intestazione |
|
| DLL |
|