Fungsi MpUpdateStart

Memulai operasi pembaruan tanda tangan.

Sintaks

HRESULT WINAPI MpUpdateStart(
  _In_     MPHANDLE         hMpHandle,
  _In_     DWORD            dwUpdateOptions,
  _In_opt_ PMPCALLBACK_INFO pCallbackInfo,
  _Out_    PMPHANDLE        phUpdateHandle
);

Parameter

hMpHandle [in]

Jenis: MPHANDLE

Tangani ke antarmuka manajer perlindungan malware. Handel ini dikembalikan oleh fungsi MpManagerOpen .

dwUpdateOptions [in]

Jenis: DWORD

Menentukan opsi untuk operasi pembaruan tanda tangan. Jenis dapat berupa salah satu dari nilai berikut:

Nilai Makna
MPUPDATE_OPTION_NONE
Tidak ada opsi khusus yang diminta.
MPUPDATE_OPTION_ASYNC
Operasi pembaruan adalah menjadi asinkron, di mana MpUpdateStart kembali segera setelah keberhasilan inisiasi pembaruan tanda tangan. (Secara default operasi pembaruan sinkron, yang berarti MpUpdateStart akan kembali hanya setelah pembaruan tanda tangan selesai.)
MPUPDATE_OPTION_PROGRESS
Pemanggil tertarik untuk menerima informasi kemajuan pembaruan tanda tangan melalui panggilan balik.
MPUPDATE_OPTION_HTTP
Pembaruan tanda tangan dilakukan dengan mengunduh paket tanda tangan lengkap dari situs portal keamanan Microsoft. Ini dapat digunakan sebagai opsi fallback jika klien mengalami masalah unduhan tanda tangan melalui Microsoft Update.
MPUPDATE_OPTION_UNC
Melakukan pembaruan tanda tangan menggunakan unduhan langsung dari berbagi UNC.
MPUPDATE_OPTION_MANAGED
Melakukan pembaruan tanda tangan menggunakan WSUS Layanan Terkelola.
MPUPDATE_OPTION_UNMANAGED
Melakukan pembaruan tanda tangan menggunakan Layanan Tidak Terkelola MU/WU.

pCallbackInfo [in, opsional]

Jenis: PMPCALLBACK_INFO

Penunjuk ke informasi panggilan balik yang digunakan untuk memberi umpan kepada klien dengan perubahan status pembaruan tanda tangan (seperti mulai dan selesai) dan informasi kemajuan. MPCALLBACK_DATA yang diteruskan kembali dalam fungsi panggilan balik melaporkan status pembaruan aktual dan informasi terkait kemajuan. Berikut ini adalah daftar kemungkinan panggilan balik:

Nilai Makna
MPNOTIFY_SIGUPDATE_START
Operasi pembaruan dimulai.
MPNOTIFY_SIGUPDATE_COMPLETE
Operasi pembaruan selesai.
MPNOTIFY_SIGUPDATE_SEARCH_START
Cari pembaruan dimulai.
MPNOTIFY_SIGUPDATE_SEARCH_COMPLETE
Cari pembaruan selesai. Informasi tambahan tersedia melalui struktur MPSIGUPDATE_DATA .
MPNOTIFY_SIGUPDATE_DOWNLOAD_START
Unduh untuk pembaruan dimulai.
MPNOTIFY_SIGUPDATE_DOWNLOAD_PROGRESS
Unduh informasi kemajuan. Informasi tambahan tersedia melalui struktur MPSIGUPDATE_DATA .
MPNOTIFY_SIGUPDATE_DOWNLOAD_COMPLETE
Unduh untuk pembaruan selesai. Informasi tambahan tersedia melalui struktur MPSIGUPDATE_DATA .
MPNOTIFY_SIGUPDATE_INSTALL_START
Penginstalan pembaruan dimulai.
MPNOTIFY_SIGUPDATE_INSTALL_PROGRESS
Informasi kemajuan penginstalan. Informasi tambahan tersedia melalui struktur MPSIGUPDATE_DATA .
MPNOTIFY_SIGUPDATE_INSTALL_COMPLETE
Penginstalan pembaruan selesai. Informasi tambahan tersedia melalui struktur MPSIGUPDATE_DATA .
MPNOTIFY_SIGUPDATE_REQUEST_PROCESSED
Layanan antimalware memproses permintaan pembaruan tanda tangan. Kegagalan atau keberhasilan ditunjukkan oleh hResult dalam MPCALLBACK_DATA.
MPNOTIFY_SIGUPDATE_REBOOT_REQUIRED
Memerlukan boot ulang untuk menyelesaikan operasi pembaruan. Kegagalan atau keberhasilan ditunjukkan oleh hResult dalam MPCALLBACK_DATA.
MPNOTIFY_INTERNAL_FAILURE
Operasi pembaruan tanda tangan mengalami kegagalan generik. hResult di MPCALLBACK_DATA memiliki kode kesalahan tertentu.

phUpdateHandle [out]

Jenis: PMPHANDLE

Handel pembaruan yang dikembalikan yang mengidentifikasi operasi pembaruan tanda tangan yang saat ini dimulai. Handel ini dapat digunakan dalam panggilan fungsi berikutnya, seperti untuk mengontrol operasi pembaruan tanda tangan. Handel harus ditutup dengan fungsi MpHandleClose .

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan S_OK.

Jika fungsi gagal, maka nilai yang dikembalikan adalah kode HRESULT yang gagal. Pemanggil dapat menggunakan fungsi MpErrorMessageFormat untuk mendapatkan deskripsi umum tentang pesan kesalahan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung
Windows Server 2012 [hanya aplikasi desktop]
Header
MpClient.h
DLL
MpClient.dll

Lihat juga

MpErrorMessageFormat

MpHandleClose

MpManagerBuka

MPCALLBACK_DATA

MPSIGUPDATE_DATA