RmGetList 함수(restartmanager.h)
현재 다시 시작 관리자 세션에 등록된 리소스를 사용하는 모든 애플리케이션 및 서비스의 목록을 가져옵니다.
구문
DWORD RmGetList(
[in] DWORD dwSessionHandle,
[out] UINT *pnProcInfoNeeded,
[in, out] UINT *pnProcInfo,
[in, out, optional] RM_PROCESS_INFO [] rgAffectedApps,
[out] LPDWORD lpdwRebootReasons
);
매개 변수
[in] dwSessionHandle
기존 다시 시작 관리자 세션에 대한 핸들입니다.
[out] pnProcInfoNeeded
영향을 받는 모든 애플리케이션 및 서비스에 대한 정보를 반환하는 데 필요한 RM_PROCESS_INFO 구조를 수신하는 데 필요한 배열 크기에 대한 포인터입니다.
[in, out] pnProcInfo
배열의 총 RM_PROCESS_INFO 구조체 수와 채워진 구조체 수에 대한 포인터입니다.
[in, out, optional] rgAffectedApps
세션에 등록된 리소스를 사용하여 애플리케이션 및 서비스를 나열하는 RM_PROCESS_INFO 구조의 배열입니다.
[out] lpdwRebootReasons
시스템 다시 시작이 필요한 이유를 설명하는 RM_REBOOT_REASON 열거형 값을 받는 위치에 대한 포인터입니다.
반환 값
가장 최근에 받은 오류입니다. 함수는 Winerror.h에 정의된 시스템 오류 코드 중 하나를 반환할 수 있습니다.
| 값 | 의미 |
|---|---|
|
함수가 성공적으로 완료되었습니다. |
|
이 오류 값은 rgAffectedApps 버퍼가 너무 작아서 목록의 모든 애플리케이션 정보를 저장할 수 없는 경우 RmGetList 함수에서 반환됩니다. |
|
사용자가 현재 작업을 취소합니다. |
|
Restart Manager 함수는 할당된 시간에 레지스트리 쓰기 뮤텍스를 가져올 수 없습니다. 다시 시작 관리자의 추가 사용이 실패할 가능성이 있으므로 시스템을 다시 시작하는 것이 좋습니다. |
|
하나 이상의 인수가 올바르지 않습니다. NULL 포인터 또는 0이 null이 아닌 값이 필요한 매개 변수에 전달된 경우 이 오류 값은 Restart Manager 함수에서 반환됩니다. |
|
작업이 레지스트리를 읽거나 쓸 수 없습니다. |
|
메모리가 부족하여 다시 시작 관리자 작업을 완료할 수 없습니다. |
|
제공된 핸들에 대한 Restart Manager 세션이 없습니다. |
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | restartmanager.h |
| 라이브러리 | Rstrtmgr.lib |
| DLL | Rstrtmgr.dll |