다음을 통해 공유

ITaskService::GetRunningTasks 메서드(taskschd.h)

  • 아티클

실행 중인 작업의 컬렉션을 가져옵니다.

참고ITaskService::GetRunningTasks 사용자의 보안 컨텍스트에서 실행 중인 작업 컬렉션만 반환합니다. 예를 들어 Administrators 그룹 구성원의 경우 getRunningTasks 실행 중인 모든 태스크의 컬렉션을 반환하지만 사용자 그룹의 구성원에 대해 GetRunningTasks 사용자 그룹 보안 컨텍스트에서 실행되는 태스크 컬렉션만 반환합니다.

 

통사론

HRESULT GetRunningTasks(
  [in]  LONG                   flags,
  [out] IRunningTaskCollection **ppRunningTasks
);

매개 변수

[in] flags

TASK_ENUM_FLAGS 열거형의 값입니다. 0을 전달하여 숨겨진 작업이 아닌 실행 중인 작업의 컬렉션을 반환합니다.

[out] ppRunningTasks

현재 실행 중인 작업이 포함된 IRunningTaskCollection 인터페이스입니다.

NULLIRunningTaskCollection 인터페이스 포인터에 대한 참조를 전달합니다. NULL 포인터를 참조하면 포인터를 덮어쓰기 때문에 메모리 누수가 발생할 수 있습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

묘사
E_INVALIDARG
 메서드 호출에 잘못된 인수가 지정되었습니다. 0이 아닌 값을 플래그 매개 변수에 전달하면 E_INVALIDARG반환됩니다.
S_OK
 작업이 성공적으로 완료되었습니다.
E_POINTER
 NULL이 retVal 매개 변수에 전달되었습니다.
HRESULT_FROM_WIN32(ERROR_ONLY_IF_CONNECTED)
 사용자가 서비스에 연결되지 않았습니다.

요구 사항

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

참고 항목

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

작업 스케줄러