Fungsi RmAddFilter (restartmanager.h)

Artikel
08/25/2023

Memodifikasi tindakan matikan atau mulai ulang yang diterapkan ke aplikasi atau layanan. Penginstal utama dapat memanggil fungsi RmAddFilter beberapa kali. Panggilan terbaru mengambil alih modifikasi sebelumnya ke file, proses, atau layanan yang sama.

Sintaks

DWORD RmAddFilter(
  [in]           DWORD             dwSessionHandle,
  [in, optional] LPCWSTR           strModuleName,
  [in, optional] RM_UNIQUE_PROCESS *pProcess,
  [in, optional] LPCWSTR           strServiceShortName,
  [in]           RM_FILTER_ACTION  FilterAction
);

Parameter

[in] dwSessionHandle

Handel ke sesi Restart Manager yang ada.

[in, optional] strModuleName

Penunjuk ke nilai string yang dihentikan null yang berisi jalur lengkap ke file yang dapat dieksekusi aplikasi. Modifikasi untuk mematikan atau memulai ulang tindakan diterapkan untuk aplikasi yang direferensikan oleh jalur lengkap. Parameter ini harus NULL jika parameter Aplikasi atau strServiceShortName bukan NULL.

[in, optional] pProcess

Penunjuk ke struktur RM_UNIQUE_PROCESS untuk aplikasi. Modifikasi untuk mematikan atau memulai ulang tindakan diterapkan untuk aplikasi yang direferensikan oleh struktur RM_UNIQUE_PROCESS . Parameter ini harus NULL jika parameter strFilename atau strShortServiceName bukan NULL.

[in, optional] strServiceShortName

Penunjuk ke nilai string yang dihentikan null yang berisi nama layanan pendek. Modifikasi untuk mematikan atau memulai ulang tindakan diterapkan untuk layanan yang direferensikan oleh nama file layanan singkat. Parameter ini harus NULL jika parameter strFilename atau Application bukan NULL.

[in] FilterAction

Nilai enumerasi RM_FILTER_ACTION yang menentukan jenis modifikasi yang akan diterapkan.

Mengembalikan nilai

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_SESSION_CREDENTIAL_CONFLICT 1219	Kesalahan ini dikembalikan ketika alat penginstal sekunder memanggil fungsi ini. Fungsi ini hanya tersedia untuk penginstal utama.

Persyaratan


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

RmGetFilterList

Bagikan melalui