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

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

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

 

구문

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

매개 변수

[in] flags

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

[out] ppRunningTasks

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

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

반환 값

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

	Description
E_INVALIDARG	메서드 호출에 잘못된 인수가 지정되었습니다. flags 매개 변수에 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

작업 Scheduler