RmStartSession 함수(restartmanager.h)

새 다시 시작 관리자 세션을 시작합니다. 사용자 세션당 최대 64개의 다시 시작 관리자 세션을 동시에 시스템에서 열 수 있습니다. 이 함수는 세션을 시작하면 Restart Manager API에 대한 후속 호출에 사용할 수 있는 세션 핸들 및 세션 키를 반환합니다.

구문

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

[out] pSessionHandle

다시 시작 관리자 세션의 핸들에 대한 포인터입니다. 세션 핸들은 Restart Manager API에 대한 후속 호출에서 전달할 수 있습니다.

dwSessionFlags

예약되어 있습니다. 이 매개 변수는 0이어야 합니다.

[out] strSessionKey

새 세션에 대한 세션 키를 포함하는 null로 종료된 문자열입니다. RmStartSession 함수를 호출하기 전에 문자열을 할당해야 합니다.

가장 최근에 받은 오류입니다. 함수는 Winerror.h에 정의된 시스템 오류 코드 중 하나를 반환할 수 있습니다.

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

동일한 세션 키가 있는 세션이 이미 있는 경우 RmStartSession 함수는 오류를 반환합니다.

RmStartSession 함수는 사용자 인터페이스를 제어하거나 업데이트에서 여러 패치의 설치 시퀀스를 제어하는 기본 설치 관리자가 호출해야 합니다.

보조 설치 관리자는 주 설치 관리자의 RmStartSession 함수 호출에서 반환된 세션 핸들 및 세션 키를 사용하여 RmJoinSession 함수를 호출하여 기존 다시 시작 관리자 세션에 참가할 수 있습니다.