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	Restart Manager 함수는 할당된 시간에 레지스트리 쓰기 뮤텍스를 가져올 수 없습니다. 다시 시작 관리자의 추가 사용이 실패할 가능성이 있으므로 시스템을 다시 시작하는 것이 좋습니다.
ERROR_BAD_ARGUMENTS 22	하나 이상의 인수가 올바르지 않습니다. NULL 포인터 또는 0이 null이 아닌 값이 필요한 매개 변수에 전달된 경우 이 오류 값은 Restart Manager 함수에서 반환됩니다.
ERROR_WRITE_FAULT 29	작업이 레지스트리를 읽거나 쓸 수 없습니다.
ERROR_MAX_SESSIONS_REACHED 353	최대 세션 수에 도달했습니다.
ERROR_OUTOFMEMORY 14	메모리가 부족하여 다시 시작 관리자 작업을 완료할 수 없습니다.

설명

RmJoinSession 함수는 보조 설치 관리자를 기존 다시 시작 관리자 세션에 조인합니다. 일반적으로 사용자 인터페이스를 제어하지 않고 기본 설치 관리자의 in-process 또는 out-of-process를 실행할 수 있는 설치 관리자입니다. 기본 설치 관리자만 RmStartSession 함수를 호출할 수 있으며 일반적으로 사용자 인터페이스를 제어하거나 업데이트에서 여러 패치의 설치 순서를 제어하는 애플리케이션입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	restartmanager.h
라이브러리	Rstrtmgr.lib
DLL	Rstrtmgr.dll

추가 정보

RmEndSession

RmStartSession