共用方式為

rmJoinSession 函式 (restartmanager.h)

  • 發行項

將次要安裝程式加入現有的重新啟動管理員會話。 此函式必須使用只能從啟動工作階段的主要安裝程式取得的工作階段密鑰來呼叫。 需要使用任何重新啟動管理員函式的有效會話密鑰。 次要安裝程式加入會話之後，就可以呼叫 RmRegisterResources 函式來註冊資源。

語法

DWORD RmJoinSession(
  [out] DWORD          *pSessionHandle,
  [in]  const WCHAR [] strSessionKey
);

參數

[out] pSessionHandle

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

[in] strSessionKey

包含現有工作階段之工作階段索引鍵的 Null 終止字串。

傳回值

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

值 意義
ERROR_SUCCESS
0
 語言函式已順利完成。
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 無法驗證會話金鑰。
ERROR_SEM_TIMEOUT
121
 重新啟動管理員函式無法在分配的時間內取得登錄寫入 Mutex。 建議重新啟動系統，因為進一步使用重新啟動管理員可能會失敗。
ERROR_BAD_ARGUMENTS
22
 一或多個自變數不正確。 如果 NULL 指標或 0 傳入需要非 Null 和非零值的參數，則 Restart Manager 函式會傳回這個錯誤值。
ERROR_WRITE_FAULT
29
 作業無法讀取或寫入登錄。
ERROR_MAX_SESSIONS_REACHED
353
 已達到會話數目上限。
ERROR_OUTOFMEMORY
14
 重新啟動管理員作業無法完成，因為沒有足夠的記憶體可用。

備註

RmJoinSession 函式會將次要安裝程序聯結至現有的 Restart Manager 會話。 這通常是不會控制使用者介面的安裝程式，而且可以執行主要安裝程式的進程內或跨進程。 只有主要安裝程式可以呼叫 RmStartSession 函式 ，這通常是控制使用者介面的應用程式，或控制更新中多個修補程式的安裝順序。

規格需求

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

另請參閱

RmEndSession

RmStartSession