다음을 통해 공유

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

기존 Restart Manager 세션에 대한 핸들입니다.

[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에 정의된 시스템 오류 코드 중 하나를 반환할 수 있습니다.

값 의미
ERROR_SUCCESS
0
 함수가 성공적으로 완료되었습니다.
ERROR_MORE_DATA
234
 이 오류 값은 rgAffectedApps 버퍼가 너무 작아서 모든 애플리케이션 정보를 목록에 저장할 수 없는 경우 RmGetList 함수에 의해 반환됩니다.
ERROR_CANCELLED
1223
 사용자가 현재 작업을 취소합니다.
ERROR_SEM_TIMEOUT
121
 Restart Manager 함수는 할당된 시간에 레지스트리 쓰기 뮤텍스를 가져올 수 없습니다. 다시 시작 관리자의 추가 사용이 실패할 가능성이 있으므로 시스템을 다시 시작하는 것이 좋습니다.
ERROR_BAD_ARGUMENTS
160
 하나 이상의 인수가 올바르지 않습니다. 이 오류 값은 NULL 포인터 또는 0이null 및 0이 아닌 값이 필요한 매개 변수에 전달되는 경우 Restart Manager 함수에서 반환됩니다.
ERROR_WRITE_FAULT
29
 작업이 레지스트리를 읽거나 쓸 수 없습니다.
ERROR_OUTOFMEMORY
14
 메모리를 충분히 사용할 수 없어 다시 시작 관리자 작업을 완료할 수 없습니다.
ERROR_INVALID_HANDLE
6
 제공된 핸들에 대한 Restart Manager 세션이 없습니다.
ERROR_ACCESS_DENIED
5
 Restart Manager 세션에 등록된 경로는 디렉터리입니다.

요구 사항

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

참고 항목

RmCancelCurrentTask