共用方式為

RmGetList 函式 （restartmanager.h）

  • 發行項

取得目前使用已向重新啟動管理員會話註冊之資源的所有應用程式和服務清單。

語法

DWORD RmGetList(
  [in]                DWORD              dwSessionHandle,
  [out]               UINT               *pnProcInfoNeeded,
  [in, out]           UINT               *pnProcInfo,
  [in, out, optional] RM_PROCESS_INFO [] rgAffectedApps,
  [out]               LPDWORD            lpdwRebootReasons
);

參數

[in] dwSessionHandle

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

[out] pnProcInfoNeeded

接收傳回所有受影響應用程式和服務資訊所需的 RM_PROCESS_INFO 結構之陣列大小的指標。

[in, out] pnProcInfo

陣列中 RM_PROCESS_INFO 結構總數的指標，以及已填入的結構數目。

[in, out, optional] rgAffectedApps

使用已向工作階段註冊的資源列出應用程式和服務的 RM_PROCESS_INFO 結構陣列。

[out] lpdwRebootReasons

接收 RM_REBOOT_REASON 列舉值的位置指標，描述需要系統重新啟動的原因。

傳回值

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

價值 意義
ERROR_SUCCESS
0
 函式已順利完成。
ERROR_MORE_DATA
234
 如果 rgAffectedApps 緩衝區太小，RmGetList 函式會傳回這個錯誤值，無法保存清單中的所有應用程式資訊。
ERROR_CANCELLED
1223
 使用者取消目前的作業。
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
 提供的句柄不存在重新啟動管理員會話。
ERROR_ACCESS_DENIED
5
 註冊到重新啟動管理員會話的路徑是目錄。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 restartmanager.h
連結庫 Rstrtmgr.lib
DLL Rstrtmgr.dll

另請參閱

RmCancelCurrentTask