Fungsi RmGetFilterList (restartmanager.h)

Lists modifikasi untuk mematikan dan memulai ulang tindakan yang telah diterapkan oleh fungsi RmAddFilter. Fungsi mengembalikan penunjuk ke buffer yang berisi informasi tentang modifikasi yang telah diterapkan.

Sintaks

DWORD RmGetFilterList(
  [in]            DWORD   dwSessionHandle,
  [out, optional] PBYTE   pbFilterBuf,
  [in]            DWORD   cbFilterBuf,
  [out]           LPDWORD cbFilterBufNeeded
);

Parameter

[in] dwSessionHandle

Handel ke sesi Restart Manager yang ada.

[out, optional] pbFilterBuf

Penunjuk ke buffer yang berisi informasi modifikasi.

[in] cbFilterBuf

Ukuran buffer yang berisi informasi modifikasi dalam byte.

[out] cbFilterBufNeeded

Jumlah byte yang diperlukan dalam buffer.

Nilai kembali

Ini adalah kesalahan terbaru yang diterima. Fungsi ini dapat mengembalikan salah satu kode kesalahan sistem yang ditentukan dalam Winerror.h.

Nilai	Makna
ERROR_SUCCESS 0	Fungsi berhasil diselesaikan.
ERROR_BAD_ARGUMENTS 160	Satu atau beberapa argumen tidak benar. Nilai kesalahan ini dikembalikan oleh fungsi Restart Manager jika pointer NULL atau 0 diteruskan sebagai parameter yang memerlukan nilai non-null dan bukan nol.
ERROR_MORE_DATA 234	Nilai kesalahan ini dikembalikan oleh fungsi RmGetFilterList jika buffer pbFilterBuf terlalu kecil untuk menyimpan semua informasi aplikasi dalam daftar atau jika cbFilterBufNeeded tidak ditentukan.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	Kesalahan ini dikembalikan ketika alat penginstal sekunder memanggil fungsi ini. Fungsi ini hanya tersedia untuk penginstal utama.

Keterangan

Buffer pbFilterBuf yang dikembalikan harus typecast ke RM_FILTER_INFO untuk mengakses daftar filter.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	restartmanager.h
Pustaka	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Lihat juga

RmAddFilter