RmRemoveFilter 函式 (restartmanager.h)

拿掉使用 RmAddFilter 函式套用之關機或重新啟動動作的任何修改。 主要安裝程式可以多次呼叫 RmRemoveFilter 函 式。

語法

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

參數

[in] dwSessionHandle

現有重新啟動管理員會話的句柄。

[in, optional] strModuleName

Null 終止字串值的指標，其中包含應用程式可執行檔的完整路徑。 RmRemoveFilter 函式會移除任何修改所參考應用程式的關機或重新啟動先前由 RmAddFilter 函式套用的動作。 如果 Application 或 strServiceShortName 參數為非 NULL，則此參數必須為 NULL。

[in, optional] pProcess

應用程式的 RM_UNIQUE_PROCESS 結構。 RmRemoveFilter 函式會移除任何修改所參考應用程式的關機或重新啟動先前由 RmAddFilter 函式套用的動作。 如果 strFilename 或 strShortServiceName 參數不是 NULL，則此參數必須為 NULL。

[in, optional] strServiceShortName

包含簡短服務名稱之 Null 終止字串值的指標。 RmRemoveFilter 函式會移除對參考服務的關機或重新啟動先前由 RmAddFilter 函式套用的動作所做的任何修改。 如果 strFilename 或 Application 參數為非 NULL，則此參數必須為 NULL。

傳回值

這是最近收到的錯誤。 函式可以傳回 Winerror.h 中定義的其中一個 系統錯誤碼 。

值	意義
ERROR_SUCCESS 0	語言函式已順利完成。
ERROR_FILE_NOT_FOUND 1	找不到指定的篩選。
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	當次要安裝程式呼叫此函式時，會傳回此錯誤。 此函式僅適用於主要安裝程式。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	restartmanager.h
程式庫	Rstrtmgr.lib
Dll	Rstrtmgr.dll