RmRegisterResources 함수(restartmanager.h)

리소스를 다시 시작 관리자 세션에 등록합니다. Restart Manager는 세션에 등록된 리소스 목록을 사용하여 종료하고 다시 시작해야 하는 애플리케이션 및 서비스를 결정합니다. 리소스는 파일 이름, 서비스 짧은 이름 또는 실행 중인 애플리케이션을 설명하는 RM_UNIQUE_PROCESS 구조로 식별할 수 있습니다. RmRegisterResources 함수는 기본 또는 보조 설치 관리자에서 사용할 수 있습니다.

구문

DWORD RmRegisterResources(
  [in]           DWORD                dwSessionHandle,
  [in]           UINT                 nFiles,
  [in, optional] LPCWSTR []           rgsFileNames,
  [in]           UINT                 nApplications,
  [in, optional] RM_UNIQUE_PROCESS [] rgApplications,
  [in]           UINT                 nServices,
  [in, optional] LPCWSTR []           rgsServiceNames
);

매개 변수

[in] dwSessionHandle

기존 다시 시작 관리자 세션에 대한 핸들입니다.

[in] nFiles

등록할 파일 수입니다.

[in, optional] rgsFileNames

전체 파일 이름 경로의 null로 끝나는 문자열의 배열입니다. nFiles가 0인 경우 이 매개 변수는 NULL일 수 있습니다.

[in] nApplications

등록되는 프로세스의 수입니다.

[in, optional] rgApplications

RM_UNIQUE_PROCESS 구조체의 배열입니다. nApplications가 0인 경우 이 매개 변수는 NULL일 수 있습니다.

[in] nServices

등록할 서비스 수입니다.

[in, optional] rgsServiceNames

서비스 짧은 이름의 null로 끝나는 문자열의 배열입니다. nServices가 0인 경우 이 매개 변수는 NULL일 수 있습니다.

반환 값

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

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

설명

RmRegisterResources 함수에 대한 각 호출은 상대적으로 비용이 많이 드는 쓰기 작업을 수행합니다. 파일당 이 함수를 한 번 호출하지 말고 관련 파일을 구성 요소로 그룹화하고 함께 등록합니다.

요구 사항

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