RmStartSession 函式 (restartmanager.h)

啟動新的重新啟動管理員會話。每個用戶會話最多可以開啟 64 個重新啟動管理員會話，同時在系統上開啟。當此函式啟動會話時，它會傳回會話句柄和會話密鑰，以供後續呼叫重新啟動管理員 API 使用。

語法

DWORD RmStartSession(
  [out] DWORD    *pSessionHandle,
        DWORD    dwSessionFlags,
  [out] WCHAR [] strSessionKey
);

[out] pSessionHandle

重新啟動管理員會話句柄的指標。會話句柄可以傳遞至重新啟動管理員 API 的後續呼叫。

dwSessionFlags

保留的。此參數應該是 0。

[out] strSessionKey

Null 終止的字串，其中包含新工作階段的會話索引鍵。必須先配置字串，才能呼叫 RmStartSession 函式 。

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

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

如果具有相同會話密鑰的會話已經存在， RmStartSession 函式 就會傳回錯誤。

RmStartSession 函式應該由控制使用者介面的主要安裝程式呼叫，或控制更新中多個修補程式的安裝順序。

次要安裝程式可以藉由呼叫 RmJoinSession 函式與從主要安裝程式的 RmStartSession 函數呼叫傳回的會話句柄和會話密鑰，來聯結現有的重新啟動管理員會話。