共用方式為

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
 提供的控制碼沒有重新開機管理員會話。

需求

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

另請參閱

RmCancelCurrentTask