Fungsi RmRemoveFilter (restartmanager.h)

Artikel
03/01/2024

Menghapus modifikasi apa pun untuk mematikan atau memulai ulang tindakan yang telah diterapkan menggunakan fungsi RmAddFilter . Penginstal utama dapat memanggil fungsi RmRemoveFilter beberapa kali.

Sintaks

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

Parameter

[in] dwSessionHandle

Handel ke sesi Restart Manager yang ada.

[in, optional] strModuleName

Penunjuk ke nilai string yang dihentikan null yang berisi jalur lengkap untuk file yang dapat dieksekusi aplikasi. Fungsi RmRemoveFilter menghapus modifikasi apa pun pada tindakan matikan atau mulai ulang aplikasi yang direferensikan yang sebelumnya diterapkan oleh fungsi RmAddFilter . Parameter ini harus NULL jika parameter Aplikasi atau strServiceShortName bukan NULL.

[in, optional] pProcess

Struktur RM_UNIQUE_PROCESS untuk aplikasi. Fungsi RmRemoveFilter menghapus modifikasi apa pun pada tindakan matikan atau mulai ulang aplikasi yang direferensikan yang sebelumnya diterapkan oleh fungsi RmAddFilter . 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. Fungsi RmRemoveFilter menghapus modifikasi apa pun pada tindakan matikan atau mulai ulang layanan yang direferensikan yang sebelumnya diterapkan oleh fungsi RmAddFilter . Parameter ini harus NULL jika parameter strFilename atau Application bukan NULL.

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_FILE_NOT_FOUND 1	Filter yang ditentukan tidak dapat ditemukan.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	Kesalahan ini dikembalikan ketika alat penginstal sekunder memanggil fungsi ini. Fungsi ini hanya tersedia untuk penginstal utama.

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

Bagikan melalui