共用方式為

RmRegisterResources 函式 (restartmanager.h)

  • 發行項

將資源註冊到重新啟動管理員會話。 重新啟動管理員會使用向會話註冊的資源清單，來判斷哪些應用程式和服務必須關閉並重新啟動。 資源可以透過檔名、服務簡短名稱或描述執行中應用程式的 RM_UNIQUE_PROCESS 結構來識別。 主要或次要安裝程式可以使用 RmRegisterResources 函式。

語法

DWORD RmRegisterResources(
  [in]           DWORD                dwSessionHandle,
  [in]           UINT                 nFiles,
  [in, optional] LPCWSTR []           rgsFileNames,
  [in]           UINT                 nApplications,
  [in, optional] RM_UNIQUE_PROCESS [] rgApplications,
  [in]           UINT                 nServices,
  [in, optional] LPCWSTR []           rgsServiceNames
);

參數

[in] dwSessionHandle

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

[in] nFiles

正在註冊的檔案數目。

[in, optional] rgsFileNames

完整檔名路徑之 Null 終止字串的陣列。 如果 nFiles 為 0，此參數可以是 NULL。

[in] nApplications

正在註冊的進程數目。

[in, optional] rgApplications

RM_UNIQUE_PROCESS 結構的陣列。 如果 nApplications 為 0，此參數可以是 NULL。

[in] nServices

要註冊的服務數目。

[in, optional] rgsServiceNames

服務簡短名稱之 Null 終止字串的陣列。 如果 nServices 為 0，此參數可以是 NULL。

傳回值

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

值 意義
ERROR_SUCCESS
0
 指定的資源已註冊。
ERROR_SEM_TIMEOUT
121
 重新啟動管理員函式無法在分配的時間內取得登錄寫入 Mutex。 建議重新啟動系統，因為進一步使用重新啟動管理員可能會失敗。
ERROR_BAD_ARGUMENTS
160
 一或多個自變數不正確。 如果 NULL 指標或 0 傳入需要非 Null 和非零值的參數，則 Restart Manager 函式會傳回這個錯誤值。
ERROR_WRITE_FAULT
29
 作業無法讀取或寫入登錄。
ERROR_OUTOFMEMORY
14
 重新啟動管理員作業無法完成，因為沒有足夠的記憶體可用。
ERROR_INVALID_HANDLE
6
 提供的句柄沒有重新啟動管理員會話。

備註

RmRegisterResources 函式的每個呼叫都會執行相對昂貴的寫入作業。 請勿為每個檔案呼叫此函式一次，而是將相關檔案群組在一起，並一起註冊這些檔案。

規格需求

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