共用方式為

RmAddFilter 函式 (restartmanager.h)

  • 發行項

修改套用至應用程式或服務的關機或重新開機動作。 主要安裝程式可以多次呼叫 RmAddFilter 函式。 最新的呼叫會覆寫對相同檔案、進程或服務的任何先前修改。

語法

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

參數

[in] dwSessionHandle

現有重新開機管理員會話的控制碼。

[in, optional] strModuleName

Null終止字串值的指標，其中包含應用程式可執行檔的完整路徑。 關閉或重新開機動作的修改會套用至完整路徑所參考的應用程式。 如果Application或strServiceShortName參數不是Null，這個參數必須是Null。

[in, optional] pProcess

應用程式的 RM_UNIQUE_PROCESS 結構的指標。 關閉或重新開機動作的修改會套用至 RM_UNIQUE_PROCESS 結構所參考的應用程式。 如果strFilename或strShortServiceName參數不是Null，這個參數必須是Null。

[in, optional] strServiceShortName

包含簡短服務名稱之 Null終止字串值的指標。 關閉或重新開機動作的修改會套用至簡短服務檔案名所參考的服務。 如果strFilename或Application參數不是Null，這個參數必須是Null。

[in] FilterAction

RM_FILTER_ACTION列舉值，指定要套用的修改類型。

傳回值

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

值 意義
ERROR_SUCCESS
0
 語言函式已順利完成。
ERROR_BAD_ARGUMENTS
160
 一或多個引數不正確。 如果 Null 指標或 0 傳遞為需要非Null 和非零值的參數，則 Restart Manager 函式會傳回這個錯誤值。
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 當次要安裝程式呼叫此函式時，就會傳回此錯誤。 此函式僅適用于主要安裝程式。

需求

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

另請參閱

RmGetFilterList