Поделиться через

Функция 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
 Функции Диспетчер перезапуска не удалось получить мьютекс записи реестра в отведенное время. Рекомендуется перезапустить систему, так как дальнейшее использование диспетчера перезапуска, скорее всего, завершится ошибкой.
ERROR_BAD_ARGUMENTS
22
 Один или несколько аргументов неверны. Это значение ошибки возвращается функцией Restart Manager, если указатель NULL или 0 передается в параметре, требующем ненулевое и ненулевое значение.
ERROR_WRITE_FAULT
29
 Операции не удалось выполнить чтение или запись в реестр.
ERROR_MAX_SESSIONS_REACHED
353
 Достигнуто максимальное количество сеансов.
ERROR_OUTOFMEMORY
14
 Не удалось завершить операцию диспетчера перезапуска, так как недостаточно памяти.

Комментарии

Функция RmJoinSession присоединяет дополнительный установщик к существующему сеансу диспетчера перезапуска. Обычно это установщик, который не управляет пользовательским интерфейсом и может запускаться как внутрипроцессный, так и внепроцессный основной установщик. Только основной установщик может вызывать функцию RmStartSession . Обычно это приложение, которое управляет пользовательским интерфейсом или управляет последовательностью установки нескольких исправлений в обновлении.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header restartmanager.h
Библиотека Rstrtmgr.lib
DLL Rstrtmgr.dll

См. также раздел

RmEndSession

RmStartSession